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This is a Component Software Product Specification. It is the definitive 
description in ieeasuc able terns oi the proposed goals, capabilities and 
external characteristics of the POSEIDON lerBjinal Server. It is the 
commitment of WfcAT IS TO BE BUILT as agreed by the product team. 

Uo changes are to be made to the product as described here, unless 
approved and documented as an amendment to this specification. 
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1.0 PRODUCT 2UKMARV 

POSEIDON is a high-performance, loin -cost terminal server for use on 
Nl-based (Ethernet) Local Area ftetwcrks. It allows a terminal user 
connected via the Nl to access any of a set of host systems on that "1/ 
and experience throughput ana apparent response time similar to a 
directly connected terminal. In addition, a POSEIDON implementation can 
offer less hcst CPU leading to traditional asynchronous terminal 
interi aces. 



P0SETDG& supports up to eight asynchronous terminals, and is offered in 
two distinct conf iguratiens. One with Models Control, and the other 
without. The Modem Control version will conform to DEC Standard 052 
alloy remote terminal access through to th US and 
networks. 



and 

foreign switched 



The POSEIDON terminal server implements the Local Area 
architec tuie, and the operational server software 
modules • 



Transport (LAT) 
consists of four 



o LA'l Protocol Module, 
o Terminal Pert Module, 
u NT For t Foctle. 
o User Interface module 



downline loadec from a Phase-IV DSCnet 
teain tenciice operations protocol (HUP), 
control the downline load process and 
handle low-level Ethernet maintenance requests. 



The operational 
host s>ste& lis 
Microcode within 



server software is 
in^ the standard 
the PGSEICCN will 



In addition, an implementation of the LAT architecture is required on the 
host side of the Ethernet. This may be provided as a host-resident 
driver either bundled with or layered upon the host operating system, or 
as a free-standing LAI host server which communicates with existing 
interfaces on the host system. host-resident drivers are currently 
planned for VAX/VHS, RSX- UM/M-PLUS and TQPS-20 systems, and a LAT host 
server ("Reverse Poseidon") is planned for support on other host systems. 



This document describes, in detail, the PQSSIDGR software features and 
operation including microcode functions, and provides a summary of the 
LAT architecture used to ccftmunicate with losts. 
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2.0 tlNV IkGNfe£«il 

2.1 Users 

The POSEIDON software aiay be utilized by any Terminal User requiring 
access to a host computer, ^uch ot the software functionality is 
transparent to the user: the main task ot transporting terminal data 
back and forth between a host system and a user terminal requires no 
additional user interface. The user, therefore, requires only the 
know led ye of the host processor cosrcand language Cor other interlace), 
and the ability to connect to the host processor. 

There is a limited 'Local fode* command set provided by POSfilOOW which 
alloys a user to connect to and disconnect tro» a host systeo, set and 
show terminal parameters tnc display host information* A HELP command is 
provides, allowing lUi.1 use ot the teramai without written 
documentation. The level oi complexity oi connecting to a host system is 
about the same as that using traditional switching devices. 

The capability ci automatically connec tiny to a pre-defined host system 
is pro video, cvoiomg the Local fcode coma ana interface entirely. An 

* u t c i K - 2 l c t v r is V* r c z to vide"*, r ! i f i r. *i t i r. o t 'he v s? e d fcr a nu <? 1 s*^ c? e d 
sped i'i cation. 

'During noo^I stiver opera t ions, one oi the local terminals as ay be 
enabled as *P r iviieoec * ioi use by a *iex»inai Manager*. This 
password-protected interlace allows the spec iiicaticn oi server 
parameters and the initiation of a aintensnce processes, and is the only 
network management interface provided with PCSEIDCN. This interface is 
also used to specify user accessibility to host systems. 

The Terminal ffianager would typically be responsible for the day-to-day 
operation of one or oscie P0SE1DC& units and associated terminals, and 
would be expected to manipulate all non-network-related parameters 
without assistance. Supervision of the Ethernet network, containing 
peseiders and best systems, would be tiie responsibility of Network 
(and/or System) Managers. These individuals would be responsible for 
defining network (LAT) parameters for the POSEIDO&s and hosts, and for 
relaying this inforaatior to the individual terminal managers* Of 
course, in certain installa tions, the Network and Terminal managers may 
be the same people. 



2*2 hardware 

1 n i i> release of trie L AT .server software is des l y ned to run on trie 
PCSEIDCN hardware exc lusive ly. The hardware configuration consists of 
the following elements : 

o 68 COO Kiicrcpiocessor (10 Muz, runriny at 7.35 Htiz) 

o 16 K.e £0* (6 KB for load/maintenance microcode, 10 KB for 
die gnostics) 
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o 12b KB 

o A PRGft containing the Ethernet accress/ checksum and test pattern 
o 512 bytes of Mon-voiatile PAH/ for stcrage of * Permanent* parameters 
o 4 2681 DU ARTS with RS-232C/CCITT V.24 interface (8 lines) 
o ANL/MQSTEK LANCE and S1A Ethernet Chips 



A iBeasory layout is shown ir Appendix E. 



POSEIDON supports most asynchronous ASCII terminals up to speeds of 19200 
bits per second (bps) in Line Mode/ and up to 9600 bps in Block Node. 
DIGITAL terminals specifically supported by PGSEIDCN include: 



o LAI 2, LA50, LUGO 

o LA120, LH80 

o LA3 4, LA36, LA38 

o VTbO/ if 152/ iTIbx as ¥Tb2# i/T6x as V l"jz 
o VTiOO, V11C1, VT102, VT12S, VT131 
o VT220, VT240 

o GIG I as VT100, VT18C as VT100 

o tihiUbuk 10C/ DECaate II and PRC/325/35C as VT10Q 



rcSLIDCL .i^oit tcriiin^LG that rmercte toth ? an. 4 «-bit 

characters. The tfodes; Control version of POSEIDON will support 
t lill-duplex ffiodeas conforming to the tiS-^ii-c and CCITT .24 standards/ 
incAuoir:t< CC IT I v. 23 irode»s. ^ode$s explicitly supported are: 



o bELL 103*i 
o BELL 212A 
o DK01/DF02/UF03 



2.3 Software 

The operational software runs on the PGSEILOfc hardware as a stand-alone 
system: no other software is required/ nor «ay any other software be 
layered upon the server software. This software is downline loaded frost 
a Phase IV DECnet host supporting the standard maintenance operations 
protocol (&QP). Therefore, QUE active Phase IV DECnet host system on the 
local Ethernet is a mining requirement for PCSEIDCN support. 

LAT support is tlso required on the host side of the Ethernet/ and this 
can be in the form of a host-based LIT driver/ or a LAT host server 
utilizing existing host interfaces. It is planned to ship a host-based 
LAT or lver as c layered product supported by VAX/¥fc3 ¥4.0. This product 
is describes in the 'VAX-ll LAI* engineer i rg plan (TBS), future support 
is also planned tor the RSX-11M/P-PLUS and TOPS— 2 operating systems. 
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2. 4 Set vices 

The POSEIDON' product is engineered to be fully customer installable. The 
PGSEIDGft software will be shipped (as required) with the hardware on the 
appropriate media for the load host (s) . A separate Software installation 
Guide will also he snipped. Upon receipt of the POSE 1 00*1 product, it is 
expected that the software jnedia and installation documentation be given 
to the system manager (s) of the appropriate load host(s) for 
installation, the POSEIDCK hardware woulc then he installed by tne 
customer or optionally by 2 Field Service representative. 

The POSEIDON software is fully supported by DIGITAL for 90 days, after 
iihich support services lay be purchased. Planned services include 
Software Maintenance Service and BASIC Support using the Telephone 
Support Center (TSC). Details on software support strategy way be 
obtained in Ref tience 4, Sei viceability iie«yuir eaen ts Document* 



3.0 bOklrnkkE CAPABILITIES 

3.1 GF**k AL DESCRIPTION 

s typical local area network configuration might consist of a nuifcer of 
terminals coiinfccieu to one or morv FGSE1LQ& terminal servers, which are 
in turn connected to the hi. Also an tne hi may be a number of nost 
systems with LAT host software support. 

I terminal user s;ay, csir.g a Local fcode coaaand, display a list of hosts 
to which he/she is authorized to access. Ibis authorization is specified 
by the Terminal manager using the Privileged Local Mode interface, and is 
co-ordinated with the System Manager(s) of the host systems. 

k user may then CONNECT to and communicate with any one of the authorized 
hosts and experience functionality., apparent response time and throughput 
s malar to a directly connected terminal* There nay be any number of 
POSEIDGfij servers and supported hosts residing on a single HI, within 
Ethernet limitations. 

Gnce a terminal is logically connected to c host, west applications that 
would normally be supported by the host operating system are supported by 
P0SEIDCN. This includes 'interactive* terminal mode applications at 
speeds up to 1S200 bp* and f low-cent ro lied block-mode applications at 
speeds up to 96C0 bps. Operation of 'passali* block-mode applications 
(HeGIS/PRG-350 tile transfer etc), and irterprocessor communication are 
supported, provided that a higher level protocol (eg: DDCMP) is in 
operation to deUct and correct any dcta overrun conditions. 

Kemote teramal operation is possible with the Modern Control version of 
PGSfeluCN. This modem ccrtrcr supports both US and foreign switched 
networks. 



The server software is logically .broken town into four elements, to 
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facilitate the possible use oi LAI on other server products- These 
elements are mo* uescrioed: 

o The L AT 1-rotocci Module - This module is responsible for 

implementing the server side of the LAI protocol* and can be 

considered the 'base* of the server software. The Protocol Module 

is responsible for: 

- Initializing POSEIDON hardware, L AT data structures and 
buffers • 

- Implementing the various filter .functions* 

- Control ling the server Circuit States and Slot States. 

- Accepting terminal input £,uiiers front the Terminal tort Module, 
and passing the» as transmit buffers to the HI Port Module. 

- Accepting Nl receive buffers iron the MI t or t Module, and 
passing then* as output buffers to the Terminal Port Module. 

- a i n t a i p i r <;j <* dat ? h nf fcc^f sih 1 e hcrf systems. 

- 11 andl ing all Connect and Disconnect requests, including 
«utoccnnect, and issuing connection status utossajes. 

- Servicing ail maintenance requests from host and user. 

- writing to the ftv. R AN. 

o The Terminal Port Module - This module interlaces between the 
Protocol Module and the terminals cheats elves via the 2681 DUARTS. 
It is responsible for: 

- Automatically detecting terminal speed. 

- Accepting input characters fros the terminals and placing theai 
in the L AT buffers in main memoir* 

- Detection and handing of flow control characters, the Local 
Switch Character and fcRRAK. 

- Handling Local Fode input, echo, processing of control 
characters and passing entire coauaands to the User Interface 
module. 

- Handling local output, including flow control, status messages 
and notification upon output completion. 

- Accepting LAT output buffers iron ©a in neisory, and outputting 

characters to the terminals. 

- Handling of woderr control. 
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o Tne fol Por t Module - This module interfaces between the Protocol 
fcouule a ii a the HI controller, as is responsible tor; 

- Accepting LAT transmit buffers, formatting the© into NI .frames 
and transmitting then to the connectea hosts over the MI. 

- Receiving ttl Frarres, filtering ur-fcanted frames, and notifying 
the Protocol Module upon completion* 

- Maintaining Ethernet counters anc providing mechanisms to read 
and zero the®. 

o The User Interface Module - This nodule handles both the 
Non-privileged and Privileged Local £ode interfaces with the user, 
and formats status messages. It is responsible for: 

- Parsing anc processing all user commands entered *hile a 
terminal is in Local £ode« 

- Notifying the Protocol Module if a CONNECT, DISCONNECT, 
INITIILlZh cr LGCP Command is entered. 

- Co-ordinating the updating of dynamic and permanent parameters, 
depending on the current server, connection and privilege 
states. 

- Conducting terminal tests. 

- Formatting and initiating output of status messages. 

During normal operations, a POSEIDON terminal server is not considered a 
DECnet node, nor does it interface with DECnet. LIT hosts need not 
support DECnet, but if the* do common DECret and LAT parameters (eg: 
Host Name) should be compatible. Certain network management functions 
provided with DECnet software may be utilized Mith POSEIDON. Section 
3.1.17 oescribes POSEIDON support in this area. 

The following sections oescrioe the external software functionality 

provided by POSfclDOl*. 



3.1.1 Local fcode Operation - 

LOCAL . v ODE is a means of communication between the terminal user and the 
POSEIDON unit, and is available to all inter active terminals except those 
*ief rneo to have a Ufu iC*l tl huST system tsee section 3 . l.b). 

Local Mode tuay be- operated in a PRIVILEGED or NGN-PKIV ILEGED state: the 
non-pi ivil eyeo state is utilized to coinect ana disconnect the user's 
terminal to or from a hast system, set and sho* terminal parameters and 
display a list of authorized hosts. This interface is available to ail 
users . 
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The privileged state is password-protected, and is utilized to connect 
and disconnect any PQSEILOft terminal, set and show any terminal's 
parameters, set and show server parameters/ perform server initialization 
and maintenance functions. Only GM terminal may be privileged at a 
time. The privilege aay be "stolen** froa one terminal to another if a 
terminal port becomes disabled tor soie reason. 

For terminals with a DEDICATED HOST defined, no Local Mode operation is 
possible. for these terminals, user operation is identical to that of a 
terminal connected directly to a host systea. Also, if a "terminal** type 
is designated as "CThEK" (see section 3.1.12), or ii it is defined as 
**»RiTE_ONL¥" or "rtEAD^ONL^", no Local Mode operation is available. For 
these terminals, connection to a host is achieved using AUTGCGNN ECT, or 
the CONNECT TERMINAL coroirand in privileged local ircde. Local tfode is 
discussed in detail in Section 3.3. 



3.1.2 host Mode Operation - 

"' , f • ■ . »- "" •, t- r~ -- ? - - 3 s ■■ , r - V ,. t r T t |l ri -> \ t - Vi -i *i r% *' t c t - <- + a w* -a r» rk 

. * w *j b i > c- v- iiui- a w w i-. t c a n. a * i C a. ta w \, tu-ii.u l.X >,. u o .* 1 ... i . ..1 i» w jf <j *. v. i<; , (3*» . ; 

is the mode that will be utilized for in est of the time. All functions 
supported by the nos t systes tnat woulc lave been available using a 

direct local interface ate available to the f C5E ICCfc use i • 

Host Mode is initiated in one oi the lollowing ways; 

o Following a CGtfNtCT command tron? Local Node, and a connection was 
successi ui iy e» tablished* 

o Following POSEIDON initialization when AUTOCOShECT is enabled for 
the teraiinai/ a default host is definec, and a connection was 
successfully established. 

o Following a host initialization when JUTOCGfiKECT is enabled for the 
tetminal, and a connection was successfully established. 

o Following a Local Fiode kESU^E cons nana, when a connection was 
established prior to entering Local rtcde. 

In Host Mode, all characters typed are sent to the host and character 
echo (if any) is performed by the host. All control characters and 
escape sequences are passed tc the host without interpretation EXCEPT the 
following: 

o The XCFF and XuN characters - it output flow control is enabled, 
these characters cause immediate flow control actions on the 
ter&inal, end ai - t asscd along to the host as well. ?lov control 
can be enabled and disabled by the user as desired. In addition, 
the nost sys tea ttay dynamically disable and enable flow control to 
perjsi t certain interactions such «s file transfers without user 
intervention. 
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o The Designated Local Switch character (or the Break key) - This 
causes an aQFF to oe sent to the host, and Local Mode to be 
iflsaiediately entered on the terminal. 

Characters such as Control/0, Controi/Y etc are host-specific 
ii»p lea en tat ions, and are processed exclusively by the host. 

fchen a terminal is in Host Mode, local ( POSEIDON-originated) status 
messages NAV appear in the xollouing circumstances: 

o if the host disconnects the terminal for soie reason. 

o If a privileged POSEIDON user terminates the session (DISCONNECT 
TERMINAL or INITIALIZE). 

o It a coiiumcd Lions tiaeout or fatal protocol error occurs yith the 
h ost, 

Status messages are delivered O&LX to the same terminals that allow Local 
Mode. (I£: DEDICATED iiOST, "OTHER", "READ_CML¥ H and W WR1TE — ONLY" 
terminals do not receive local status messages)* 



3.1.3 AUtODaud Capability - 

Autobaud is a means by which the PLSE1DC& unit can determine the input 
(and by assumption output) terminal speec of a particular terminal, and 
adjust the current terminal parameters to that speed. If input and 
output speeds of tht terminal are differ- tuts autobaud will not function 
correctly. 

The autobaud feature is implemented by posting a read to a terminal with 
autobaud enabled hhen POSEIDON is initialized/ or after a LOGOFF command. 
When the user types a carriage return <Cft> , the bit pattern of the <CR> 
will be matched to one in a set of possible values, each matching a 
different terminal speed. If a table entry matches, the input and output 
terminal speeds are adjusted, and either AuTGCOKNECT begins or Local Mode 
is enabled on the terminal. If the bit pattern does not match any in the 
tables, another react is posted and the user shcuio enter another carriage 
return. 

This feature is particularly useful for modem-cent rolled terminal lines, 
autobaud is enabled by default, and, yhen enabled, overrides any 
previously-defined terminal speed. 

The autobaud capability available to POSEILON aiay be restricted because 
ot certain characteristics of the IJAMb. iince these characteristics are 
unspecified, the extent ot the autofcauc' capability may be determined only 
after iaple&entation. 

3.1.3.99.1 Extent of Autobaud Functionality to be defined after 
implementation 
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3.1.4 Local S*itch Character - 

Since trier e are t*o user t»oees available at the user's terminal (Local 
and Host modes), a way tc initiate each m cue is required- Entering Host 
Hocle is discussed in section 3.1.2. 

To enter Local fcooe Mhile in Host aode, the 'Local Switch Character* may 
be typed in. finy ASCII character OR the creak key may be defined as the 
local switch character in a SET TERMINAL cciiand. The default is the 

t. je\ q *u\ Key. 

Upcn entering this character, an XGFF character is sent to the host, the 
Host Mode session is suspended, and Local Mode is enabled on the 
terminal. 



3.1.5 Lost Access Control - 

Th« tyric^! e th erne t environment rcay cent.? in literally 'hundreds * ot host 
systems and terminal servers (in addition to other servers). These 
servers and hosts may cicss many different organizational components of 
customer sites, £ach of which may need tc access only a snail subset of 
tne services. 

A facility is provided tc assign ACCESS CCDES to both hosts and 
individual terminal users. On both the FGSEIDCN and arfected host(s), 
access codes idy i>e entered only by a #1 iviieged user. Access codes 
provide both protection and a acre efficient directory service (see 
section 3.1.7). One or ffiore access codes ere assigned to each terminal, 
and one or iore access codes are assigned to each host. If any ONE 
access code is assigned both for the terminal and host, then the terminal 
is authorized to access that host (and CON SECT requests are honored). Up 
to 12 ! 6 access codes may be specified, numbered Q ~ 127. 

In addition, only the hosts for yhich a particular terminal is authorized 

to access are shown in the SHOE HOSTS cisplay. 

As a further method of access control, hosts may reject connection 
requests on a per-server or per-teririnal basis, based on other attributes 
passed to the nost at connect tiiae, or for any reason at all. The 
overall philosophy of access control alleys the local POSEIDON Terminal 
Manager to define the environment for the terminals for which he is 
responsible, and alio* the host systes to accept or reject this 
environment at connect ti«*e. 
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3.1.5 Host £aaies - 

Every host that supports tie L AT architecture must be assigned at least 
QbE name/ ana this first name must be unique within the local network and 
not change while the host is accessible. Names may be from 1-16 
characters in lengthy arc contain the f cilcwing characters: h-Z, a-Z/ 
0-9/ $ (dollar) and _ (underscore). An example of a valid naie is 
™LAT$HGS1L1 ,, « Lowercase naaes are logically equivalent to uppercase 
names* 

Host naaes are utilized in CQUNECT commands, and are displayed in the 
SHOW HOSTS cowanc/ and are the only leens of referencing a particular 
host system. 

To support VAX clusters/ the capability exists to assign up to seven 
dddi tional group n a* e s to a host sys tea/ and allow different sys teas to 
share names. Together wit! each host name* a host RATING from 0-255 is 
also assigned. %hen a CGKNECT request is issued, the host with the 
highest rating FGk THAT kAMt will he selected for connection. Specific 
hosts may be referenced by their unique nana under all circuimstances. 

for pxatol & hos t *ay be <jssl«f»eri n <m i<:»t<e nwe {$MM)€), and have two 
group natives (COiMPUTfcfc ard VAX) that are shared among hosts. The hosts 
will conspire aion y st themselves as to which has the highest rating for 
the naues Cf!*f»Uf t'fc End VAX, so that the user requiring access to any 
CONFUTE!* way simply say CLf&iECT HUS'i CG*PU1£K and kill be connected to 
Che COf-ilr ISTEi-c with trie highest rating, b or those it ore demanding users who 
require access to a specific host/ CCfcNHCf fiOST S ft AUG nay be entered. 

Tt is expected that hosts sharing names will regularly adjust ratings in 
such a way as to evenly distifaute the processing load. 

If a group name is specified in a CONNECT command/ or is defined as a 
Preferred or Ledicateo host, the POSEIDON software will make every 
attempt to connect to, and maintain a connection with, one of the hosts 
in the group. If, for example, the highest-rated system in the group 
does not respond, or terminates a connection/ the FGSEIDGUi software will 
automatically attempt to connect to the next highest-rated system within 
the group. This will continue indefinitely until a connection is 
established, or a DTSCCfcfcECT command is entered in local mode. This 
feature is called Autoconnect (see section 3.1.6) and may be enabled or 
disabled on a per-terminai basis. 

If an existing connection was broken, and communications subsequently 
established with a different host in the group, a HBW connection is 
established, and no continuation of any system activity from the old 
connection is transferred to the new. If and when the host operating 
oysttiw su^or Ix ^es^ ion recover y, the PG^r. iuufc soi t*c*.r e will be updated 
(if necessary) to also support it. 
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3.1.7 ftost Directory Service - 

At any given tine, a terminal user asay yisfc to know fchat host systems are 
currently available to hi as. the SMC ^ HOSTS coajsand lists all the hosts 
that the user is authorized to access/ and they are displayed by name. 
For any name that is a group name, a list of hosts in that group will he 
displ ay ed. 

The display yiii also consist of host identification and status. The 

status way ba one of REACHABLE, UNREACHABLE, OVERDUE or DELETED. Only 
those hosts designated REACMBLE or QVERDUfc nay he accessed by a CONNECT 
command . 

The host directory service is maintained as a result of host systems 
informing servers of their presence at regular intervals of 10 seconas - 
3 ainutes. II these kfcssages are received regularly, and no connections 
time out or terminate abnormally, the host status is marked as 
"EEACHAiiLE *. It POSEIDON has not heard ir cm a host for 6-8 minutes, the 
host's status is changed itom Hk&Ch &bLi to Oil RDUE, alerting the user 
that the host may be ccwn, CONNECT requests are honored if the host is 
eitner in kEACBAo LS or OVERDUE status. 

If no information is received fcr 30 m mutes, cr a connection sas 
ter&inated abnormally, the status is changed to btihEhChkbLi and a ay no 
longer ce accessed. If no information is received f oi 24 hours, (or the 
host oata base becuries tuiij the host is deleted f rem the data base 
entirely, and nc information about it is retained. 

More detailed information about a specific host »ay be displayed using 
the "SEC** HOST host.r.aKe * coaiifcand. Host counters *ili also be included 
in this display. 

The privileged terminal user may SHL-fc ALL HOSTS, and receive a list of 
the hosts that $LL of the terminals on the PGSEIDCN tsay access. If none 
of the terminals on a POSEIDON ffiay access a particular host system, no 
data about that host is retained, and hence it cannot be displayed. 

POSEIDON reserves 30 KB of uemoiy fcr storage of host systems and names • 
This aiiiount will support the storage o.t over 200 host systems, and 50 
group names. If an Ethernet contains acre than 200 hosts, the 
tero?inai/systei!< managers should assign access codes appropriately, so 
that individual POSEIDON units kill not recuire access to more than 200 
hos ts . 



3. 1. b MUtocountc t Capaui ii ty - 

AUTUCON.Nf.CT is a function that automatical iy connects a user terminal to 
a hot- 1 s y a t € ir- mhtn connection isiiuies occur, or upon POSEIDON 
initialization. 

if AUTO CONNECT is enabled, but no DEDICATE! or PRE? ERRED host is defined, 
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then Autoconnect operates cniy upon abnormal te m i rati on of a connection, 
or upon failure to establish a connection. (An abnormal termination is 
any disconnection that is NOT because of a DISCONNECT, INITIALIZE conwand 
or host LOGOUT.) Upon such te rnunat i on, tie PCSE1DGK will atteiapt to 
reconnect to the same host. Attempts to reconnect will be ssade at 30 
second intervals, and continue indefinitely unless local aoae is entered 
by the user. 

If the terminal had been connected to a GROUP host, Autoconnect functions 
slightly different! y u^oo abnormal tei aination. Instead of trying to 
connect to the saie host system, attempts bill be made to connect to 
another host within the group, and so cn through all the hosts in the 
group until either a connection is established/ or local mode is entered 
by the user. 

In ctdai tion, A u&blCA'i tu nubl or kHz* thh&U uuST ft«y ue. specified with 
Autoconnect. when either of these are specified, Autoconnect will 
attempt to connect to that host upon FCSfcllGN initialization/ or when a 
CONNECT coftisand (with no host naie) is entered, as yell as upon abnormal 
tera ina tion. 

II u dieted V o s t iz ..r-cilied, au tcccr.nect attempt to connect to 

that host 'tor ever*, until the connection is successfully established. 
This conf lgurat ion is designed to simulate a local terminal interface 
act iy, and h^nce there is no Loce 1 K-ode or PCSE ID OK- initiated status 
messages. 1 r the host goes down, trie user will only notice a lack of 
response, just like a local system. however* autoconnect will still 
attempt to re-connect to the host (or another host in the group). 
Autoconnect is el nays enabled when a Dedicated host is specified. 

If a Preferred fcost is specified, autoc cnnect yiii also attempt to 
connect to the host 'for ever*, unless Loccl Mode is entered. »hen Local 
Node is entered, the autoconnect procedure is suspended and the user may 
then Sum H0S1S or CONNECT to another host as desired. If a connect to 
another host is not perforflied, Autoconnect may be restarted by entering a 
RESUHE command. Status aessaqes aay te issued to terminals with a 
Preferred Host specified. 

If Autoconnect is disabled, ail connection failures result in an error 
uiessaye being displayed, and Local fcode being entered on the terminal. 

The LOGOUT coerce nc iray be used to disconnect from the host and also exit 
out oi Local soce. Upon entering this coasaand, the Autoconnect procedure 
halts and is not restarted until a L0uC& occurs. 



3.1.9 1' low Control - 

Floy Centre! is a means by which a 
terminal) may inhibi t transmits 
adequately buffered to receive 
[. cssibili ty or cat a c-vei runs is 



receiving station (Host, POSFIDQN or 
to trial station until the station is 
the data. kith flow control, the 
iiini.ffi.ized (or el urinated). POSEIDON 
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pcsesses an extremely flexible and effective flow control mechanism. 

Flow control between the PCSEIDGM and the host system is sanaged at the 
LAT protocol level by a creeit scheme. Receiving stations, when thay are 
prepared to receive data, pass a credit to the transmitting station. 
Credits are maintained cn a per-terninel basis and are passed in slot 
heaaers (see section 3.2.2). Transmit anc receive credit counts are 
maintained by both stations. Transmits nay only occur when transmit 
credits are available. This flow control is bi-directional and is always 
enabled. 

Flow control between the PCSE10GN and the terminal is achieved using 
special characters termed *XGFF * and *Xui**. ihen a station (POSEIDON or 
T&RtflMAL) receives an XOFF iron another station, it must inhibit ail 
transmits to that station until an XC& is received. There is usually a 
Sitsall 'grace* ptilod lor the station to coaply: iOiiLlDOil will allow up 
to 10 extra characters to be received froa the XCFF'd station before data 
overrun occurs. 

Since this for© oi flow control utilizes special characters, its use iaay 
not always he desired, especially if "binary** data is being exchanged. 
*>0St« iDf'fc * 1 1 own t k p ter^ir?! us*r tc 5^»ci f t iy en«*£ \ e cr disable input 
(from terminal) or output (to terminal) flow control. 

Certain situations require that flow contrcl be dynamically enabled and 
disabled. instead oi requiring the user to repeatedly enter cowwands to 
achieve tins, the capability exists to allow the nost to dynamically 
enable or disable f low control. Since both the Terminal User and host 
system can enable or disable ilow control, the following priorities are 
in t- 1 act • 

State set by User Action Final State 



Disabled 


User 


D isabl e 


Disabled 


Disabled 


User 


Enable 


Enabiec 


Disabled 


iiOSt 


Disable 


Disabled 


Disabled 


host 


Enable 


Disabled 


Enabled 


User 


Disable 


Disabled 


r; n ••■> k i »-v a 


User 


Enable 


i'i a b 1 e o 


fcnab led 


host 


Disable 


y isabled 


fcnab led 


Host 


Enable 


Enabled 



The user comisanc will always operate ana override any state set up oy the 
host. 

Flow control is enabled by default. The XCFF and XGN characters are DC3 
( he. a. 13) d(iu LL i t, n« a li> respectively. 

In addition to tiow control, LuSS NCTIf I CkTlhH may be enabled on a 
per- tera: ina i basis* Tf enabled, the <»iL character will oe output tor 
each character lost because of insufficient buffer space. This alerts 
the user that the character must be re-ertered. To effectively utilize 
flow control, the following set-up is recoa«ended : 



POSEIDON Software Specification - CCfcPANV. CCHFICENT.UL 
i?lo* Control 



Page 20 



Line mode terminals BiccK mcde terminals 



output Floy Control Enabled Output Floy Control Enabled 

Input Floti Control Disabled Input Floy Control Enabled 

Loss Notification Lnabieo Loss fcotirication Disabled 



3.1.10 Modem Control - 

The ^odeift Control version of PGSEIDCN conforms to DfiC Standard 052, and 
supports the following 3 fcrirs of Modern Cortro 12 

o I*o-*ay s iftul taiieous, Syfluaeti ical (*u 11 -Duplex) 

o Tfco-yay s iaultaae cus, Asynse trical using Special Cable 

o Data Leads only ^ode. 

This conforms to the EI A HS-232C and the CCITT ¥.24 standards for 
full-duplex fficceftSy inducing CC1T1 St. *3 loaeis using the secondary 
cr* !»nnc f • u i I f-"U"^ ,,v fo^cF control if V ? JT si'p*^o r<? d • 

All calls are originated irofo the terminal into the POSEIDON; dial-out 
and iroden; speed select are not supported. 

Hie suppor ted aoaeffl signals are; 

Naiue Pin Description 



A A 


1 


Protective Ground 


B A 


£ 


Transmitted Data 


Bfo 


3 


Received Data 


CA 


4 


Request to Send 


CB 


5 


Clear to Send 


cc 


o 


Dataset Ready 


AB 


7 


Signal Ground 


CF 


8 


Received Line SiynaJ 


CD 




Data Terminal Readv 



Models specifically supported are PFLL 103d, BELL 212ft, DF01/2/3. 



3.1.11 Terminal Support - 

Since H")SF10O*J performs no interpretation of data characters, all 
asynchronous ASCII terminal devices sup k oited .by the host terminal class 
driver (up to a speed of 19200 hps) are supported by POSEIDON in Host 
Mode. See section 2.2 for a list of terminals explicitly supported. 

Flock if: ode terminals at speeds up to 9£00 Dps are also supported. 
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provided that they honor input i Lou control or utilize a higher-level 
protocol to detect and correct any data overrun errors. 

POSEIDCfc supports both 7-bit and 8-bit character sets in host wode. To 
support a 7-oit cnaracter set (ASCII)/ the terminal and the POSEIDON aay 
be set up to exchange either 7 or 6 bit characters (terminal and Poseidon 
roust be set up the saiue way)* It set up to exchange 8-bit characters, 
bit 7 will be a zero. The parity bit (it enabled) is NOT sent to the 
host in bit 7, and the host must MOT output a parity bit in bit 7 . 

It an 8-bit character set is usee!/ both terminal and POSEIDON must be set 
up to exchange 8 bits (either yith or without parity). All eight bits 
are sent to the host, and all 8-bits received flow the host will be 
output to the terminal* 

The Local Kode interface functions only with the 7-oit ASCII character 
set. Bit 7 in all local mode input is ignored, and is zero on all local 
mode output. &ote that this places a restriction on host naaes, 
identification etc, which «ust utilize only 7-bit ASCII* 

The specification oi terminal parameters stch as terminal speed, nusber 
of stop h i ts? etr #us t he done f ro» I oral *oc? vsins trie Ill&L or 

lit? 1 N E TFhMIMAL cowicands* Mo host-based specification of parameters is 
supp orted. 



3.1.12 Terminal raraaeters - 

Several options that it ay be set on a per- terminal basis have been 
described in the preceding sections, litter parameters »hich may be set 
on a pet- terminal basis are as follows: 

o In t ut Terminal Speed. The input (Terminal to P0SEID0JO terminal 
speed may be specified. Legal values are 50, 75, 110, 134, 150, 
200, 300, 600, 1200, 1800, 2000, 2400, 4800, 7200, 9600, 19200 
bits/second (bps). The default is 96C0. 

o Output Terminal Speed: The Output (PCSEIOGN to Terminal) terminal 
speed nay be specified. Leqal values are 50, 75, 110, 134, 150, 
200, 30C, tOO, 120U, 1800, 2000, 2400, 4800, 7200, 9600, 19200 bps. 
The default is 9600. 

Altnough 9o00 is a default for terminal speed, autobaud is also 
enabled by default. The 9600 default only becomes effective if 
<iu f ooa ud is m i s a a 1 to . 

For ,j character size of eiyht bits, no parity bit/ one start bit and 
one stop tit, the chciacter tfrrcuo,hptt in by tes/seccnu is one tenth 
of the terminal speed. 

o Character Size: This re ay be 7 or 8 bits. The default is 8 bits 
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which can be utilized on aost terminals. Support of t> or 6 bit 

codes is not provided. 

o Parity: Parity aay be enabled or disabled, and if enabled may be 
even or ode. The default is parity disabled. 

o Number ot stop bits. Tne default value is two. Legal values are 1 
and 2. 

o Type: Terainal Type a ay be defined as HARDCOPY, SGFTCGPY, AhSI and 
OTib £R. It iiAfiDCOPV is specified, all Local Wode output yili be 
compatible yith hardcopy terminals, arc the delete icey Mill echo the 
deleted character Deti»een slashes. 

If SGFTCGPY. is specified, the delete key (in Local Mode) will erase 
the deleted char ac iei iro<& the screen, and backspace the cursor. 
This applies also to IfcSI. 

If AM SI is specified, the tfTlOG A&S1 escape sequence support will be 
assumed on Local. f^oce output {Note: VT52-coapatible terminals are 
net ANSI type). 

It OTHcP is specified, it is assumed that the device is not a 
terminal at all, arc Local Kode anu status messages will not be 
erahied or. the device. Connect ic rs irust be performed via 
Autocormec t, or iroi trie rriwilegeu Local Moae interlace* 

Pead and/or fcrite access may aisc be specified as a TYPE parameter, 
and may be "K EbD_UR II fc", "SEAD^CfcLY*' or M «R iTE^OfcLV". The default 
is "READ^aRIIE". This parameter is specified by a privileged 
command. Local ^ode and status messages are enabled only for 
""R E AD_^R I T E ,< terminals. In addition, output is disabled for 
"RE AU_uNLY" devices, ana input is disabled froai * , «ftITE_ONL¥ M 
devices. 

o access Codes: Access Codes authorize the terminal user to access 
hosts containing at least one of the saise codes. This parameter is 
specified by a privileged conieanc. The default is access code zero 
enabled (all others disabled), yhich will alloy access to all hosts 
yhich also default to access code zero. 

o Naroe: A najne of up tc 10 characters pay be specified for each 
terminal. the naise is sped tied in a pr ivileged SET TERMINAL 
coiBfliand by the Terminal manager, and &ay be be used for any purpose, 
ftoi&aliy, the name would identify the terminal user, or location if 
shared by users. 

in the case of pr in tela and other non-teriHina i devices, the naae may 
be utilized to idert i f y the device to host systeirs. The name is 
passed up to t.ne host in the connection procedure, and the host may 
utilize it. ( in conjtnc t ion wi tfr other inf oraiation ) as a logical name 
which may be allocated to processes ir. the system. in this way, it 
is possible that devices connected via POSEIDON may be used by host 
systems in any way that a directly- connected device aay be used, for 
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example as a spooled output device. 

Such uses ot the device naae, however, are functions of the 
host-based L AT product, and are not explicitly-defined features of 

the POSEIDON Terminal Server. 

Other terminal parameters have been previously discussed. See section 
3.3.2 for the coma and syntax lor entering terminal paraaeters. 
Discussion of server paraffleters is providec in section 3.2.5. 



3.1.13 Application Support - 

£11 interactive ciode teiaural applications supported by the host terminal 
class driver are supported cy POSEIDON. 

Special terminal lodes/ escape sequence recognition and the like are 
performed by the host terminal class criver end the terminal itself. 
FOSLIDCN peifcms no special lunctions. 

L AT handles single-character, r ead-*i th-no-ecno f unc tions, as exhibited 
in such utilities as ETT and CLT, bat response tiflie may be slightly 
slower than on z directly connected terminal. Section 8.1 gives details. 



3.1.14 Security - 

Tn order to provide security flora unauthorized users, access to the 
POSEIDGk functions (including Local &ode) may be password-protected on a 
per-line basis, the terminal Manager nay specify a LOGON' PASSWORD for 
the POSfclDGS in privileged aode, and then specify which ports require the 
password to be entered* If enabled, the password Bust be entered at the 
lolloping tiroes: 

o Upon I^ITULIZATIOfl of the PCSEIOC^. 

o Following a LOGOFF conffland In Local Mode. 

When the terminal is logged off/ the user should enter one cr mote 
carriage returns to notify the POSEIDON that service is required. If 
LOGON is enabled a 'Bel* character is output to the terminal* and the 
user has a specified nujrher of attempts (1 - NCL1NIT) to enter the 
password. It the password is entered incorrectly lor the specified 
nufflwer ui cunsecu t i*e « i te»p ts, the teiftinai port is oisaoieo. it may be 
re-enabled only upon a privileged command, cr upon POSEIDON 
initialization. 
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3.1-15 Server initialization - 

The POSEIDQH server, and LAI software, may *>e initialized in two ways: 
either by electrical power-up or by a software INITIALIZE conmand in 
Privileged Local £ode. The following processes occur upon 
ini rial ization : 

1 Warning messages are sent to the users at one minute intervals 

indicating that the server is about to re-initialize* (Initialize 

?--*-♦„ i ,» ••, 

4. J -IS X jf J 

2 All active terminals and virtual circuits are disconnected* 
(Initialize Only). At this point, tne software status, uptime and 
dump host fields are initialized* 

j Coiiti oi is passed to the ^eli-tes t diagnostic which then executes* 
Upon successful self-test the front light is illuminated, and 
control is passed to step 4. if self-test detects a fatal error the 
unit will halt and should he referred for service* Upon detection 
of a sett error, the diagnostics will blink the front light, then 
pass toe error status to the aicrocode, and continue with step 4* 

4 The POSElDGfc microcode optionally outputs hardware/load status 
uie^sages, then coffi&euces to downline load the operational LAI 
software. This operation will typically take about 10-15 seconds* 
(uetaiis of the loading process are given in section 3*4*2 and 
Appendix I). 

b If AuTCBAUl is disabiec, go to step 6. If AtiTLB AUD is enabled for a 
terminal, input is enabled* «hen the user enters a carriage return 
(probably much later) and the terminal speed is successfully 
determined, the terminal initialization logically continues at step 
6. 

6 For all terminals with LOGON enabled, a BEL character will be output 
to the terminal* This is a proapt to enter the LOGON password* 
Once the password is correctly entered, control passes to step 7* 
If LGGO&l is disabled, control continues at step 7. 

7 All terminals with a specified Dedicated ct Preferred Host are 
connected to that host* If this f ci Is, the autoconnect procedure 
will continue to retry tnis event until Local fcode is entered by the 
user. If the specified host is c grotp naiae, a connect attempt will 
be made to all hosts in the group (in priority order) until a 
connection is successful. 

8 All terminals with no default host are put into Local Mode, and the 
*LCCAL> * pr o«ipt is tiity- iayed. 
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3.1.16 Software Support Tools - 



Support services in the ioim of an SPh service and telephone hotline will 
be made available to the user lor reporting suspected software errors. 
Maintenance will oe performed by a Software Engineering Maintenance Group 
and shipped tc users in autopatch releases (as with other layered 
products) . 

Tools will oe provided to diagnose atm correct POSEIBCN software 
problems* A diagnostic online debugging tccl (GOT) will be provided, 
which may be used to obtain detailed information about sottware crashes. 
The information provided can then be relayed to the Maintenance Group via 
SPR's or telephone hotline. The GDI interface is described in the 
"POSEIDON Online Debugging Tool Specification". 

There are several bugchecks within the POSEIDON software, which are 
activated upon any illccicai or "*ir p os sibl e" condition that may occur 
within the software system, or a fatal hardware error. They are MOT 
activated on any user error, or illegal message received over the 
fcthernet. If a bugcheck is activated, a systes crash occurs. The 

:. Li/t<i.i(ui. « wjf 4- w COiii j, a lit 'v t.0 w J.. 1 1 L v- L U »T j.- its «T. G r j i ID 3 Q c to u host 

s> Steffi for later analysis upon system cr ash. Appendix J gives details on 
the upline uufftp operation. 

?h* PSX/V^S I hi utility way he used to update the PUS PI DON software on 
the host. The i&age file contains a sa»ai 1 header, followed by printable 
ASCII text. Scftware specialists cr customers a«ay utilize updates 
provided in Software Dispatches or by telephone, when the need exists to 
update the soitware prior to the shipment of Autopatch. Tne iaiage file 
contains a checksum which must be correctly updated, otherwise the 
software will net be runnacle on the POSEIDON. The EDT utility is 
described in the KSJC/VM3 documentation sets. 

The maintenance strategy lor correcting errors in the ROM-based Microcode 
is a release oi a new SOU. No patching facility is provided for the 
ROM-based code. 



3.1.17 Maintenance Functions - 

Tne PUb&lflGUi Xeresinal Servei is a fully supported DIGITAL node on the Mi. 
Maintenance functions are implemented so that the server operation nay be 
controlled and monitored by the Privileged Local Bode interface, without 

active assistance by any host processor. 

The icilowing C theme t iciatenance functions (as tiescrioea in the 
maintenance operations rictocc-I s £ £c i I i ca tion ) arc piovided, and their 
par t icuidi io»p le«>entat ion is outlined : 

o Loop Server - Tne LAI server iispl ereen ts the Ethernet Loop Server 
functions as follows: 
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- Enable Server: This function is implicitly defined as part of 
the F C b e 1 C I N mi 1 1 a i 1 za t io n procedure. The loop server is 
enabled following a success! u J initialization and remains enabled 
at all tiuies that the server is in normal operation. 

- Disable Server: This function is implicitly defined as part of 
the POSEIDON initialization procedure/ and is in effect Irom the 
start of the diagnostic self-test function until successful 
initialization eenipieticn. 

- Enable Assistance/Disable Assistance: These functions are not 
iiiipieaien ted. The loop server never responds to the lookback 
assistance puiticast address. 

- Pead Status: This function is i«ple»ented as part of the SHOW 
SkSTEH coffi^and. The loop set vef state and assistance state are 
displayed. 

o Loop kequester: Since POSEIDON is designed to be controlled from its 
own interface/ the following Loop Requester functions are supplied: 

- f,oo r, f ) ir(? r t * T h T € r w i'P. a I **ar<*oer f sv test 3 I i nfr oetween the 
p OSElD0*» and any other specific station/ or the loop assistance 
SRUiticast address, by issuiny a *LGCF station* coaaand in 
Privilege c Lccal *ode. A response is provided within 5 seconds, 
lad ica tiny whether the test was successful. 

-LoopAssis ted i The Terminal Manager isay test a link between the 
POSLlDOfc and a specific station, using the assistance of a third 
statioa by issuiny a *LCCP station * ITii function ASS 1ST station* 
conniand in Privileged Local ^ode. k response is provided within 
5 seconcs/ indicating uhether the test yas successful. 

-Looppoll: This function is iroplictiy defined as part of the LOOP 
procedure. No user interface is supplied. 

-LoopAbort: This function is implicitly defined as part of the 
LOOP procedure. If a response to a LOOP command is not 
forthcoming within 5 seconds/ the loop function is internally 
aborted, ana a failure states is returned to the user. 

o Console Server Euncticrs - Because POStlD0.fi! *ioes not support remote 

console carrier functions, this liinirauffl subset of console server 
functions is deiined: 

- Identify-Se 1 t function - A system-ID message is sent to the 
console server f&ul least address at intervals of 10 minutes plus 
or uiifiiii e ran oo m interval up to * m mutes, ii seconds. the 
system- id message certains all fields required by the HI Node 
architecture specification/ arid also the lolloping: 

- 101 Conudun ica tion Device delated - biagnost ic Status 

- 102 CoiBUiunica tion Device Related - ROM Version dumber 

- 1C3 Coaitaunication Device related - Sol tware Version dumber 
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- 1C4 Communication Device kelattd - Server dumber 

- 105 Communication Device Kelattd - Server Name 

- 106 Communication Device f elated - Server Location 

- I^ead-Identi ty function - A system-ID message is sent to a 
requester node that issues a Read-Identity function to the L AT 
server rode. 

- fieao-counters function - A Couriers asessaqe is sent to a 
requester node that issues a Read-Counters function to the LAT 
server rode* 

In addition to Ethernet maintenance functions/ a TSSf lEftHlKAL function 
is provided for users to determine whether the U APT/cable/terminal 
sub-systenf is functioning correctly. There are three variations of TEST 
T l. K f - 1 i<t A L as i. o 1 j, o * i • 

o Tf ST TLRHIKAL - This r cn-priviiecec coma and outputs a rotational 
display of all printable ASCII characters on the requesting 
terminal* The display a ay De visually examined for errors. The 
test is stepped oy typing any chatacter during the test. 

o TEST Ttfct-r.il* A L n - This privileged function outputs the ASCII display 
to a specified terminal (where n is The display is visually 

exairired f cr orrcrs. The furcticr is stopped by entering the 
privileged Slut 1ES1 l&KfcliiAL n coataand* 

o TEST TERMINAL n LOOPOCK - This privileged function requires that 
the terminal ioopback connector is inserted into the specified 
terminal port prior to issuing the coAJuand. The rotational ASCII 
pattern is yritten to the specified terminal/ read back and compared 
fcr errors. The test is stopped by the STOP TEST TERMINAL n 
coinnianG, after which a message containing the number of errors and 
bytes transferee! is displayed on the privileged terminal. 

The privileged TEST functions may not ue applied to the requesting 
terminal. 



3.1.18 Software Reset - 

since terminal and server parameters may bt 'permanently* taodified and 
stored in non- volatile memory# a aietbcd tc reset the unit to its factory 
(default) settings is recuired. This is especially useful if the 
Privileged Mode password is forgotten, terminal parameters are set up to 
'bad* settings, and when individual PGSElDOi units are transferred into a 
different *±nv i i cuuen t oi i e turned Iron btrvice. 

This feature is provided by a SGFTMSE LESET button located on the 
PUSh ID ON box itself, and is activated by d^pressiny the RESET button 
ynile simul tanetusly remov ing and insert mc the power cord. linen the 
Terminal Manager activates this control, en immediate initialize occurs, 
and ail perraanert and dynamic parameters are reset to their default 
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values. This control shctid QhL)t be activated when absolutely required, 
and not as a matter ot course, Normal powerf ail and INITIALIZE will not 
cause the unit to reset to factory settings. 

The RESET function is implemented in the diagnostic self-test code. 



ft *T SDrUT! ifTtltC OUCtliT 



This section presents an overview oi the LAI architecture sufficient to 

illustrate the meaning of various L hi server parameters. The 

architecture definition is provided in Reference 6. Appendices C,D and £ 

outline the circuit state processing/ slot state processing and message 



ILDK 



3.2.1 Virtual Circuits - 

Communication between PUStlDON and e host system utilizes a synchronous, 
packet-oriented pr o tocol/ following the tab 1 ishiisen t of a VIRTUAL 
CIRCUIT. f Virtual Circuit associates a P13EICGN with a flost system/ and 
ail terminals coiinecr.ee to that host wiii utilize a single circuit. 



^hen a user requests to CONNECT a terminal to a host/ and no othe 
terminals on the PQSLIDCN are communicating with that host/ a Virtua 
Circuit iii initiated between PCSEIDCN and the host. The POSEIDG&" sends 
STAKT NESS AGE/ containing server parameters and other ittioraations to th 
host. Curing this process/ the POSEILOU circuit is in the START STATE. 



The host exannes the Start Message and decides whether to accept or 
reject the Circuit Connection. If the host accepts the Circuit 
Connection/ it sends a Start Nessage back to the POSEIDON, and the 
circuit becomes established. Slot connection (section 3.2.2) is then 
performed. 

PGSEIDOf* then transmits RUN MESSAGES, containing input terminal data, 
control information and acknowledgements/ to the host at regular 
intervals determined by the CIRCUIT TI**fcfc (section 3.2.3). The host 
responds to each message by aisc sending s Run message containing output 
terminal data/ control information and acknowledgements. The POSEIDON 
circuit performs these activities in the RUk state. 

If no data is waiting for transmission for any terminals cn the circuit/ 
FOScIDCti tr ansmiis nUt* i*c,SoAGES at &uch longer intervals determined ny 
the EEP_ AL I V f tinier (section 3.2.4)/ and the circuit enters the WAIT 
state. If data ther becomes available/ the FUN state is re-entered. 



This continues until one 
terminate the circuit, 
the circuit disconnects. 



of the stations (host or POSEIDON) decides to 
horffiaily, this occurs when the last terminal on 
but may be initiated fcr a variety of other 
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reasons. The station then sends a ST LP MESSAGE to the partner, upon 
which bcth stations will terminate the circuit. The circuit will enter 
the HALT state. 

Appendix C sun. ©arizes the processing involved yhen various EVENTS occur 
while a circuit is in one ct the above circuit states. 



3 • "2. . 2 blots ~" 

The Virtual Circuit protocol handles the data transport between a 
POSE JuOti and a host, management of indivicuai TEhWINAL DATA is perforated 
using SLOTS. Run Messages consist of a circuit header, plus zero or oiore 
slots, each slo t corresponding to one o£ lie connected terminals. 

5 *rhen a user CONNECTS tc a host, and following the establishment of a 
virtual circuit, slot connection takes place. POSEIDON sends a STAkT 
SLOT, including terminal pcrameters and other information, to the host, 
during this process, the slot is in the bTJKT STATE. 

The hosi exaf ines the Start Slot anc oecides whether to accept or reject 
the Slot Connection. If the host accepts the Slot Connection, it sends a 
Start SI ot back to the PCSE1DCN, and the slot beccces established. The 
slot then enters the fcuf* STATE. 

Terminal input and output, which occurs directly to and from slot 
bufiers, is actually transported by the virtual circuit protocol, yith no 
slot s tii to transitions. 

This continues until one of the stations (host or PGSE1DCN) decides to 
terminate the terminal connection. formally, this occurs upon a user 
DISCONNECT coiiand/ but tsay be initiated icr a variety of otner reasons. 
The station then sends a STOP SLOT to the partner, upon which both 
stations will terminate the slot. The Slot alii then enter the HALT 
state • 

Appendix u summarizes the processing invoiced when various EVENTS occur 
while a slot is in cr.e of the above slot state; 



*3 . 



3.2.3 Circuit Timer - 

The Circuit Tisec defines the interval bet keen messages sent f roa the 
*Gbt JuGtt to a nost system. The circuit timet may range f root 30 - 200 
milliseconds, ard applies to all circuits cn the l-OSf-'IDLN. 

Under no ci rc urn stances will messages be sert as ore often than that defined 
by the circuit timer, even if mere than one message is required to 
transmit all waiting slots; slots not transmitted in a given message 
will be sent AfTEH the circuit timer interval in the next massage. A 
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round-robin slot selection process will ensure fair service to all slots- 
Selection of the circuit tiroer value should be co-ordinated between the 
neeos ot the terminal users on the PLSfciDCfc, and the capabilities of the 
host systems yhich they will access. A shcrt circuit timer interval will 
potentially iciniirize response tiae to the user, but saximize host 
loading* A long circuit timer minimizes best loading, but extends user 
response time* 

The default circuit timer value of 80 es i£ reconaended for interactive 
terminal use cn timesharing systems. Host system roanagers are urged to 
define the j»ini»uia circuit timer value to be BO sis. This value provides 
fast response (40-50 ms average) to teiainal users, while at the same 
time offloading host interrupt processing compared to such local 
interfaces such as the DZ1.1. 

The circuit timer value nay be reduced for use on stand-alone, or 
underused, host systems tc mi maize resporse tine* For systems that are 
very heavily used, a longer circuit timer yill increase CPU capacity for 
compute-in tens ive applications. 

A sbo.c *■ Circuit Tiwec value will increase overhead traffic on the 
Ethernet/ since wore messages with less data per message will be 
tr ansisi t ted. Data throughput is constrained by terminal speed, and is 
gerernliy not affected by different Circuit Tiirer values. 



3.2.4 Feep_ Alius Tiiser - 

The KEEF.AL1VE TIMS defines the interval between messages on circuits 
where no data is being transported. This parameter is much less critical 
on overall performance than the Circuit fitter, but nay have an iapact on 
a heavily-loaded Ethernet. The default value of 30 seconds is 
recoifii ended for timely status information to users in roost environments. 

A value of 10 seconds provides fast status information, but will increase 
Ethernet traffic, especially if many PCSEIDQ^s are in operation. For 
Ethernets that are near or at maximum capacity, the maximum value of 180 
seconds should be used. 



3.2.*> server Parameters - 

The Piiiiicueij Luc «.l * ode in tec .f <*ce ai lows the spec if ica tion of various 
server parameters, w'nich way be used for PCSf-IDGN identification or 
protocol variab ies. tar air. e ters affecting the LAT protocol were discussed 
in the previous sections, tther speci tiab le parameters include: 

o Server dumber - This is a value froft 0-65535 that way be used in any 
May to ider.tify trie PCSfclOtiN unit. It is suggested that a different 
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number be used for each PG3EIDLN en tie local netwerx. This number 

is passed to hosts in Start Messages/ and is included in the System 

Identification message sent upon request from a host system. The 
default value is zero. 

o Server Naae - This 0-16 character ASCII field is used to identify a 
POSEIDON urit by name, or may be used (at the option of the Terminal 
Manager ) tc identify type, ownership, usage cr any other relavent 
meaning. This field is passed tc hosts in Start Messages, and 
System Identification messages. The default value is the name and 
option number cf the FCSEIDCN. 

o Location - This 0-16 character ASCII ireld is used to identify a 
PGSFIOUN location, or may be used (at the option of the Terminal 
Manager) fcr any other meaning. This field is passed to hosts in 
Start HtiSiayei/ end Sys tea Identification messages. The default 
va lue is si aces • 

o Privileged node Password - This 1-6 character ASCII field is used to 
gain access to the Privileged Local ^ode command set. This value 
shcuic be unique for each POSEIDON or group of PGSEILONs managed by 
* simile TVrerinal v^naqer/ and shoul 1 not he oovious. Only 
necessary and knowledgeable users should have access to this 
password, otherwise the performance cf the entire network iaay be 
compromised. 

The Terminal Manager should remember the password. It a password is 
forgotten, the POSEIDON unit Bay be re-initialized to its factory 
settings using the reset button. The default password of 'SYSTEM* 
will then take effect. The use of the reset button will also 
initialize all terminal and server parameters to their default 
se t tings. 

a Logon Password - This 1-6 character ASCII field is used to gain 
access to PGSEIDGN functions if LCGGN is enabled for a terminal. 
The password must be entered after iQSiiIDQN initialization or a 
LOGOFF com»and following output cf a "prompting" Sel character. The 
default LGCG& password is 'ACCESS*, but should be changed prior to 
normal use. LOGON is enabled by default, and is seen to be 
especially useful lot modem lines. 

o The SOKT*MRP._ 10 parameter specifies the name of the POSEIDON 
sottware load image tile residing on the host. The following 
filenames ere defined, one of which is stored in the ROM area of the 
POSEIDON unit at factory ship (depending on the version of POSEIDON 
or cer eci) : 

- F Sutfv lfc Ku.aVS - PGSF IDCK/b, no modem control, E n g i l s a 

- FSOHOii-'^C.sys - POSEIDCM/P, modem control, English 

- PS0803E NG.S'YS - Reverse POS EIDGN/8, English 

If the Teririnai nana get wishes tc ioac an alternate software image 
into the unit, the file descriptor should be specified prior to 
initialization using the DEFINE SERVER SUFTk'ARE_ID command. The 
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tile descriptor 
tieiaults apply: 



is limited to 16 characters, and the to 1 lowing 



- for VfiX/VKS systems: 



- for KSX ays tens: 



3 YS $3YST £M : filename. SYS 
LB: £1/ 54311 lenane* SYS 



o Console - Lne of the eight POSEIDON terminals may he designated as a 
CONSOLE terminal/ which may be utilized by GDT and upon system 



V» 1. u o 1 1 ■ 



console ter 



ial is speciiicd/ a systems crash will 
output a two-line crash message to the console terminal, and display 
the Ethernet address c£ the upline duap host (if dunp is enabled). 
The console terminal will also oe used as the OUT interlace (if ODT 
is enabled). 



uniy G1*E terminal stay ce designated as tne console terminal 
default is that tensinal port 1 is th€ Console terainai. 



ine 



DuriP - It the 
crash. The 
perfotKseo upon 



POi fi IDt IN 
Terminal 
crash. 



software detects a fatal logic 
Manager stay request that an 
This co»«and ©rabies the dump 



error, it way 
Upline Dunp ne 
process. The 



rip f ?»y 1 t -j 5« f^;fnr» f' j 5 *h 1 p d • 



- Tne ciagnos tic &ictocode contain* an Online Debugging tool - 
This say * c en at- led using the OtT £ft JIELES coEEand. A CCNSGLE 
terminal asus t oe defined prior to enabling Qui. Once enaoied, ODT 
*iii pioiiipt at the CUai^ULE terminal upon each oi tne to 1.1 owing 
conditions : 



- Upon system crash (after up lire dump) 

- Upon a pre-set ODT breakpoint Deing hit 

- Upon a ODT cosmand being entered from privileged »?ode 

- Upon initialization (alter downline load) 



Heartbeat - Ail Ethernet tranceivers conforming to the Ethernet V2.0 
spec must enable tre 'heartbeat* collision detect circuitry, but 
this is tiCt a requirement for Ethernet VI. 0. Cy default, if absence 
of heartbeat is detected, the L AT software (but &OT Microcode) will 
get a transmit error en all transmits, and hence will not function. 



The 



Hi? 1QT 



- « — — — — - • — , _ _ _ _ - - — - ~- — - - - 

LED co air. and is provided to alloy POSEIDON usage 
with transceivers which do not have the heartbeat circuitry. If 
heartbeat is disabled, heartbeat errors are ignored and not counted. 



3.3 USER INTERFACE 



This section describes the Local Mode interface provided with POSEIDON, 
including ail cosffiands, op t ions and status messages. This command set is 
conspatiDle with tne laT ia^pieroentatior; supplied by other DIGITAL Terminal 
Servers. 



If a terminal is speciti.ee to be password-protected by the Terminal 
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Manager, a password ffiust be correctly entered to access POSEIDON 
functions (either host or local codes ) . Ilie password must be entered 
upon POSEIDON initialization or following z Local l*ode LOGOFF command. A 
'Bel* character (Beep) will be output to the terminal after which the 
user has a specified number of attempts to enter the password. The 
password may be fcoa €-16 characters, and consist ci any valid local aiode 
character (see below). The password is not echoed on the terminal. 

Local fode »ay be initiated as the cefault ©ode upon POSEIDON 
initialization, or in one ct the following * a y s : 

o The Local Switch character (or break key) is entered by the user 

o If Autobauc is erahiec, the user may type carriage return, ard Local 
Hode ail I be entered* 

o Upon circuit or terminal disconnection for any reason and 
Autcconnect is disabled. 

In Local #ode, POSEIDON reads, echoes ana processes all input entered at 
the terminal. io facilitate usage, (ard lor compatibility with other 
Die 7TM f.nt*»rf*c*»5) + bp fell owirg turct i on? ir 3 prcvidec in Local Mode : 

o D CLE IE Key - Deletes Las t Character Typed. Deleted character echoed 
between slcshes on a hardcopy terminal, erased on <-» SOFTCOPY or ANSI 
teifiiiriai . 

o COKTHOL/U - Deletes current input line. Echoes as *~U*. 

o CQETRCL/i? - Re-echoes entire input lire. Echces as *~R *. 

In addition, output flow control (XCN/XOFF) is fully supported, and a 
function is enabled to terminate terminal tests. 

Coaifiiand lines up to 132 characters may be entered. All commands should 
be terminated by a carriage return: other coupon line terainators 
(escape/line feed etc) are not supported as line terminators in Local 
^ode. 

Commands may be entered in upper or lower case, and are converted 
internally to upper case. Ail local iscde exchanges utilize the 7-bit 
ASCTI character set/ and valid co^and characters includes 

A-Z, a-2, C-9, $ (dollar) and (underscore) 

Local node commands may he typed ONLY when a proapt is outstanding. 
Local type-ahead is not supported if the proapt has not yet been issued. 
7i?e oiti&nib ate 3 b f oi lewh : 



All keywords way be abbreviated to 3 or mere characters, and optional 
keywords is ay be omitted. For exaaple, the "DEFINE SERVER CIRCUIT TIMER 



LOCAL> 

PHI LLC A L> 



Bion-privileged st*ite 
Privileged State 
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ICO* command may be abbreviated to as little as *DEF CIR 100*. The 
entire keywords 'SERVER* and 'TINEH* are optional. 

Certain commands alioii the modification of terminal or server parameters. 
Temporary modifications should be issue c using the SET command. These 
changes are stored in dynamic ffleaory, take effect immediately and remain 
in effect until changed cr until a PQSEIOOK initialization occurs. 

It a parameter is to i>e changed permanently, the DEFINE cowhand should be 
issued. The DEFINE cons and should be iss ted ONLY, for permanent changes # 
and not as a regular procedure. DEFINE commands update only the 
permanent memory ( NVPAP) in the POSEIDCK/ and do not aifect the current 
state of the server. 

Local Hode is always entered in the Non-privileged state. To enable the 
Privileged sta te/ tne iolio»ing coiianc shtulo he issued: 

LQC AL> SET PRIVILEGED 
Passuor d> 

The password is not echoed. if another terminal is already privileged/ 

•t h*? ^oliowirn ?»rrcr ?p £ r^cf* 9 Is Gis^ i ?y <*d ard p ri v i 1 ene i *? not oi v*»ns 

LOCAL -nn~ Terminal n is already pr iv il tged 

It is possioie to 'Steal* the privilege tro» tne other tecamal by 
entering the following command: 

L0CAL> SET PRIVILEGED OVERRIDE 

This command should only he entered if the currently privileged terminal 
is out of order. Only one terminal may be privileged at any time. 

For each cowaiano described in the neat two sections, a description of the 
command is given, together with the meanings of any options. Examples 
are given tor non- trivial commands. 

The COfcfeAND RESPONSE is the normal response that would be output upon 
successful completion. It NONE is given, the output of the f 'LO€AL> M 

prompt serves as the command response. 

The ?R»CR RESPONSE'S) document the possible errcr messages that may 
occur. &ny error response results in the non-execution of the entire 
command: the state of the system after the coaaand is the saie as that 
before. 

Certain error responses may occur on any comaaiid, and are not 
individual iy documented, these are as t oi jows ; 

LOCAL -no- Command syntax en or 

LOCAL -no- Pr ivileged command or option 



LOCAL -mi- Keyuord "XXXXX" net known 
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LOCAL -im- Value invalid or out of range, *' value** 



3.3.1 Command Set Summary - 

The NQ.N— ?RI V ILEGED co&aands avaiiabl e in Lccal ftode are summarized oeloy; 

CONNECT CHGS13 Chost-naaeJ 

<DEf 1NE | SET} TERMINAL characteristics 

DISCONNECT 
LOGOFF 

r.ELF Ltcu&ft hCT I D&F1NE j DlSCb.N& EuTi LLuOr k |i<ESU^fc I SfcTi SiiG* I TEST! J 

s * r T b f j i> T h o i, t _ n a a; e 
isHGfc CGNNFCTb 

i> i« t j «* i > Li ^> r <Li 

SHU* iLKMikAL 

Tile h r' i \» lL.fr LL L C G Hi III 3 HO £ 3I€ 3 U8il« ar 1Z e G Oei CU 1 



CQHktCt TERMINAL ii|2|...|d> CBGST host^naaeJ 

iDEFlNE i SET> <LQGON 1 PRIVILEGED! PASSWCiU 

CDEFi&EI SET> SEP^tR characteristics 

iDbF lftfc, | aEl> it,titt I ft AL il|2| |t>> characteristics 

DISCONNECT TERMIWIL < 1 1 2 | . . • | 8> 

HELP CIDEf I^feJ INITIALIZE iLCGP | SOT JSTG^i ZLROiJ 

INITIALIZE C ABORT 3 

CDELAV ainutesl 

CDIS ABLE! 

CTEST options! 
LOOP STATION stationl.id 

CfclTH ITi<AfcS*ITiREC£I¥EjFULLl ASSIST STATION station2_id3 

ODT 

SHOW AlL CONNECTS 
SHOW COUNTERS 
SHOK JILL HOSTS 

SWi SEBVER 
SHO* TERMINAL n 

STOP TEST TERMINAL i 1 1 2 i • • • 1 6 ) ALL> 

TEST TEPhlNAL L U 1 2 | . . . i 6 I ALL> 3 CVIDT*. rnl lCCLKT nn3 L LGCFBACK 1 

Itm COUNTERS 
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3.3.2 !*on-pr iv iieged Commands - 

o CONNECT OI0ST3 Chost.naoiel 
SET HOST Chost.naseJ 

The CONNECT comasanQ logically connects a terminal to the specified 
host system. The nost nasoe is the 1-16 character raae of tne nost 
systeiii, optionally followed by a double-colon. SET HOST is provided 
for DECnet/VAX compatibility. 

If no host naie is specified, «n attenpt to connect to the Preferred 
Host (if any) is made* 

Examples : 

LOC AL> CONNECT 

LOC AL> SET HOST BEkGIL:: 

Command Response: 

LOCM -mi- Connpction to nor t X>XXX Y «f;ta^) i^fipi 
trior f.espcr.ses ; 

LOCAL -nil- hoo t XXXXXX not .known 

LOCAL -nn- Host XXXXXX not available (code xx) 

LOCAL -nn- Connection already established 

LOCAL -nn- Connection to host XXXXXX not established 
Host rejects connection (code xx) 

LOCAL -nn- Connection to host XXXXXX not established 
Host does not respond to connect request 

LOCAL -nn- Continuing attempts to connect to host XXXXXX 

LOCAL -nn- Preferred host not defined 



o DISCONNECT 

The DISCONNECT command logically disconnects the terminal from the 
connected host systeav or cancels connect attempts initiated by 
<iu loconnec t • ? ci iotoin v the d i bcoiuiec ti or , Local «ude is entered ana 
the *LOCAL>* prompt is issued. 

C0B»anc Response: 

LOCAL -nn- Disconnected iron? host XXXXXX 
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Error .Response : 

LOCAL -no- No connection established or requested 



o HELP L {CONNECT! DfcFIHt i. DISCONNECT I LOGO if | RfiSUWEi SLT 1 SHOi f T EST> 1 

The d£LP ccmmand displays a list ci coiaancs available in Local 
Mode. If a keyword is supplied, the command provides help on the 
command specified. 

hxample * 

Luc Ai» > duLP L u i* « fj C i 

Command Response; 

A Help display as shown in Appendix € 

J-'f cor Spsncns*; 

LOCAL -mi- Key*cr d "XXXXX" not known 

followed by the HELP display sncwn in Appendix G.l 



o LOGOFF 

This command effectively terminates the user's entire terminal 
session. If a host is connected, a DISCONNECT is activated. The 
LGCAL> prompt is NOT re-issued, and any modem connection is 
terminated. To re-use the port, the LOGON PASSWORD (ii enabled) 
must he entered. If LOGON is not enabled, local mode may be 
regained by entering a carriage return, following a successful 
LOGON/ dynamic terminal parameters are reset to the permanent values 
stored in Ky_RHI4. 

Command Response: 

LOCAL -nn- Logged off terminal i; 



u RESUME 

This compare is effective after Local Mode has been entered during a 
terminal/host session oy aesns of the Local Switch character (or 
break key), and is used to exit Local $ode and resume Host Mode. 
kESUHf also restarts autcccnnect if a requested connection was not 
successfully established prior to entering Local node. 
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Coffin?and Response; 

LOCAL -nii- Connection to host XJXXXX resumed - OR « 

LOCUL -nn- Continuing attempts to connect to host XXXXXX 
Lrror Respcnse: 

LOCAL -nn- No connection established or requested 



o SET TERMINAL characteristics 
DEFINE TERMINAL characteristics 

The SET TERMINAL command enables a teim inai user to modify dynamic 
terminal parameters* The DEFINE TERMINAL cowaand enables a user to 
fflocny permanent terminal parameters* Tenuinai parameters are 
discussed in section 3.1.12* One or more parameters may be entered 
pet comfiiancv separated by a space, coins a or both* 

Trie characteristics may consist of one ot the foi loving: 



aUlCLGhNcC i iEK ABLfcD i U i bABLt D > 

Lria;<ALifci< 6 12E C 7 1 8 > 

PREFERRED hOST <hos t.nase HiONE> 

K.PU1 cLLk CCNTRCL iiwAELEDI L IS ABLE0> 

XtlFUT STEED Li ts_per_se cond 

LOCIL CSfeITCH]l CHAtfACTfifc tchac I SREAKJ 

LOSS OCT IFICATIGfU < EN ABLED J DISABLED! 

LUIPUT FLOte CGI*T£OL iEN ABLEDj D IS ABLEDl 

OUTPUT SPEED Dits_per_second 

PARITY <GDD|EV£N!1I0«E> 

SPEED d i ts— per— second 

STOP BITS <1I2> 

T VP E <HARDCQPY|SQFTCOPY IANS.I> 

Ex amp 1« : 

LOC AL> SET TERMINAL AUTQCOfiNECT ENABLED, PREFERRED HOST SHAUG 
Command Response: 



o SHOW CONNECTS 

The SHU*? CINMEtTS command displays i rfoimation about the current 
connection status of ttie terminal. 



Command Response: 
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Tne display as shown in Appendix t • i is output. 



o SHOU HOSTS Chost^naa^eD 

The SHOfc HCSTS command displays information about host systems 
accessible to the terminal user. The command cones in two flavors: 

- li 'SBQm HOSTS' is typed/ a one- line -per -host display of all 
hosts accessible to the user is output. The information 
contains host nase, status and abbreviated ID message. 

- If "ShOi HOST host_na«e* is typed, more detailed information 
about the specified host, including counters. Hill be 
disp layed. 

SHOW HCSTS display examples are shoun in Appendix F.2 and i«.3. 
Error nesponse: 

LCCAL -nn- Host AXX.XXX net known 



o SHOW TERMINAL 

The Snu* T&Halw Au command display s tne dynamic and permanent 
terminal parameters and current connection status lor the user's 
terminal. 

Example: 

LOCAL> SBm TERMINAL 
Command Hesponse: 

k Siiuis TERMINAL display example is shown in Appendix r.4 



o TEST TERMINAL LMiDtli nnJ CCOUNT nnJ 

This command instructs PLSilOGfc to test the user's terminal* A 

rotating ASCII pattern, containing lines ot the specified &lDTki, are 
output to the terminal. ¥idth may from 1 to 255 characters. 

If no yidth is given, a default of 70 is used. 

The COUNT parameter defines hoy many lines are output. It not 
specified, the count ail I be indefinite, and tne test may be 
terminated by entering any character (or BREAK) on tine terminal, or 
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entei ing a STOr TEST TfcRMl&AL 
M o d e • 

Ex amp lei 

L0CAl> TEST TERMINAL VIDTH 

Cobb? and Response; 

it* s \ * * _ >ni t> 

I +f v ~® v J ' / ~»y wit j 

i«#$l~*()*+ J ,~./Q1234 

/G12345 
#$t~*O*+,-./0123456 



coaaiand from the Privileged Local 



20 CCO NT 48 



(user types on terminal) 



3.3.3 trivileged Com»anos - 



c CONNECT TERMINAL < 1 1 2 t . • . I 8? £ HOST tiO£t_naire3 

Hi is command implements the saiae miction as the non-pr lvilege d 
CC&KECT command, except that a specific user terminal is specified. 
This cosffiaiid is provided in order to connect devices which do not 
have a keyboard (steh as an output-only printer), and NOT to 
override the user's connection at the terminal. Bence, the 
specified terminal must of the type "0THEF% or have a DEDICATED 
iiOST specified, and not support Local Mode. 

If the HOST name is not supplied, the specified terminal is 
connected to its dedicated or preferred host (if any). 

Ex amp le; 

Co»wand Responses 

LOCAL -nn- Connection to host XXXXXX established 

Error Responses : 

LuC AL -nn- host XXaaXa not knoi» i< 

LOCAL -nn- liost XXXXXX not available {cede xx) 

LOCAL -n.n- Connection already established 

LOCAL -nn- Correction tc host XXXXXX not established 
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Host rejects connection (code xx) 



LOCAL -nn 



Specified terminal supports local mode 



LOCAL -no 



Preferred host not defined 



o DEFINE <L0GQNJPRIV1L£GED> PASSWORD 
SET <LOGGNJPRIVILEGED> PASSWORD 

This command changes the LOGON or PRIVILEGED password lor access to 
the reiavent PGSEIDC& functions* SET PASSWORD changes the dynamic 
password; DEFINE PASSWORD modifies the permanent password, 

yhen either coamand is entered, two password prompts are issued. 
The same 1-6 character aiphanuBser ic password should be typed in 
response to each prompt* Since the password is not echoed on the 
terminal, the dual entry minimizes the probability of a spelling 
error in the password. Example: 



It is important that any permanent change to the PRIVILEGED password 
be reffiembered. 



y DEFINE SERVER characteristics 
SET SERVER characteristics 

The DEFINE SERVER characteristics updates permanent server 
parameters. The SET SERVER characteristics updates dynamic server 
parameters. DEFINE SERVER commands may be entered at any time, and 
take effect upon the next initialization. SET SERVER commands ntay 
be entered only when no circuits are active, preferably with user 
terminals disabled. One or acre parameters may be entered per 
command* Section 3.2.5 provides a description of server parameters* 
The list ot set table parameters are: 



C TRCu IT I ffii i i iseconos 

CONStLE <n|NONE> 
UMP O W AfrLEL j LI SABLE D> 
HEARTBEAT 1 ENABLED) DISABLED! 
KEEP ALIVE TlfcER seconds 
LOG Al ION "iocation^tejKt" 
NAME **naase_ text** 



PR 1 V_LuC AL > LEFINE LOGON PASSWORD 

Password^ 

Passvor : 1> 



} Type password 
; Repeat password 




u one 
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KUfcBfcR integer 

uDT f£ftABL£Di DISABLED) 

SGFTI* ARE_ ID filename 

Cotpfl?and Response! 

None 

Error Response: 

LOCAL -nn- Parameter cannot be aodified, connection established 

LLC /> L -nn- Paraireter cannot be cynanica lly modified 

LOCAL -nn- Console terminal not defined 

tiote that the keyword SERVES may be ositted f ro» any SET SERVER or 
UEMNF SERVER coffniand. 



o DEFINE TERMINAL <1|/|.-.fR> ch*r?ct er i s t ir? 
SET TERMINAL <l|2|.«.|i£> characteristics 

this coram ard alleys the privileged user to define or set any 
terfiiinai *s ±>ar aaeters* The ter&inai m»us t ue idle and not connected 
to a host when this command is given. The characteristics are the 
sane as fcr the non-privileged DEFINE/SET TERMINAL* except that the 
following additional characteristics aay be set: 

AUTGBAUE f ENABLED) DISABLED! 
DEDICATED iiQST fhos t.na&e 1 NONE! 

ACCESS i ENABLED | LIS /!8L£L> CODES iO 1 1 1 . . . 1 127 1 ALL! 
LQGO^ { ENABLED j DISABLED! £{ LIMIT nn | NOL 1M IT) 1 
NODEM < ABSENT I PRESENT! 
jkAME "nane^text" 

TYPE fHARDCOPYISCFTCOPY IANSI I OTHER! 

tREAD_liRITEJREAD_OM,YI «RITE_0iyLO 

see the ron-gr ivilec.ed OFF IKE/ SET TFKMIKiSL cofiaand for tore 
inr ocmatior • 

fcxaii>] e: 

PR11ULGCAL> SET TERMINAL 1 LGGGIi ENABLED LIMIT 10 
Co»mand Response; 

n U lift 

LOCAL -nn- Para&eter cannot be cynaoucaliy modified 
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o DISCONNECT TERMINAL 11 | 2| | S> 

This coBHBdrd disconnects a specified terminal from the host system 
that it is currently connected to. It is functionally similar to 
the non-privileged DISCONNECT cosisand. The command a»ay only be 
issued tc a terminal of type "UTilER", or one with a DEDICATED HOST 
specified* 

Ex a asp let 

PK'IV_LGCAL> DISCONNECT TERMINAL 4 
Command Response: 

None 
Error Response; 

lOCAL -nn- No connection established 

LOCAL -nn- Specified terminal supports local aiode 



o HELP I COM iNEi INITIALISE! LGur i SE1 i SIO* j ZEi<0> J 

This cosi&arid is functionally similar tc the non-privileged HELP 
command, except that information about privileged coanands is 
available, as «eil as th non-pr iv iiey fed coaffiands. See Appendix G 
for details. 



o INITIALIZE CDELAV ffiinfctesl CD IS A EL E 3 IT EST options! CABGKTJ 

The INITIALIZE cooaand instructs PQSEIDGN to per for® an orderly 
shutdown of norflial operations, execute the diagnostic self-test, and 
re-initialize. Section 3.1.15 deserifces initialization. 

If the 'DEL A* minutes* option is given, the initialization will take 
place ir the specified number cf mi rutes. At one minute intervals 
prior to initialization, yarning iressages are printed to all 
terminals alerting the users that the local systeo will be 
re- initializing. The delay variable »ay vary between and 255 
minutes, ard the defatit is 5 nrinutes if no 'DELAY* option is given. 
To get an ln&ediate initialization, 'DEL A if 0* should be entered. 

If the 'T?S? nnticnr* keyword is g iven, non-standard diagnostic 
testi* will be performed. The options will be defined at a later 
d ,? t e . The default is the standard se if- test diagnostic. 

3.3.3.99.1 Define Test Options for initialize command. 



POSEIDON Software Specification - CGfcPANV CCNFXLgNTlAL 
Privileged CoMands 



Page 44 



if the DISJcLE keyyorc is given, the fceyiy-init lalized POSEIDON Mill 
not alloy au t oconnec t or any Local f^ode cowhand except 'SET 
PRIVILEGED*. Once a terminal is privileged, all coaaands are 
honored. To re-enable the server tor normal operations, another 
INITIALIZE command, excluding the DIS/BLE keyycrd, must be entered. 
This option alloys tor maintenance tunctlons to oe carried out on 
the PGSE1DCN without interference from other users. 

The ABORT qualifier has the effect of aborting a 
previously-requested initialization, which has not yet taken effect. 
Regaining yarning messages yill be cancelled, and the server will 
continue tc operate normally. 

Examples : 

FF I *_LuCi?L> Iti Hi AL.il> £ i).cL&)t iu 

PRIV L0CAL> INITIALIZE DELAY EISABLE 



Command Response (ail ternsinais): 

t.PCAf, -nrs- 
LOCAL -nn- 



lUCAl -iui- 
LOC A L "UL" 



ending in nnn minute (s) 
ending in nnn ininute(s) 

• . . . 

• • • * 
ending in 1 winute(s) 



^APNTfcf: — Local nrvz ?ervic«? 
WA^Nl&G — Local area service 



WARMfcG — Local area service 
Lceai area service ere 



o LOOP STATION station_id 

This command instructs the POSEIDON tc atteiipt to communicate with 
the specified Ethernet station using the Ethernet maintenance 
protocol heply function. This command tests the physical 
connectivity between stations, and the station need not be a LAT 
host systeai. A message indicates ii the test is successful or not. 

Example: 

PRI¥_LO€AL> LOOP ST AT TON 1 C-1F- 23-4 3- 1 A -00 
Command Response: 

LOCAL -nn- Loop test successful 
L i l Oi Rei> M oils e i 

LOCAL -nn- Loot- test failure 
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o LOOP STATION statiuni-id ilTH -CTRAhSM IT | RECEIVE! FULL> ASSIST STATION 
s tation2-ic 

This command instructs the server to attempt to communicate with the 
specified station! rsing the Ethernet Maintenance protocol Forward 
Message and Reply turctions, with assistance from stations. The 

message ^aths are as follows: 

Transmit Assist: PCSfc IDC K-s t a ti cn2- st at ionl -POSE IOCS 

Rev- e xV <e x z* \. • r uo c iuun-cj its la tai a — £> t«a t r uos^i uuik 

Full Assist : PGSETDON-staticn2-stationl-station2-PGSEIDON 

This comward tests the physical connectivity between stations, and 
the stations need not be LAT host systems. 

C.X ditiy I til 

l-fcIV_LGCAL> LGGF STATION 1 G- 1 ir- 23-43-1 A-00 *I?H FULL 
ASSIST STATION 10-2 j- 19-00- 13-00 

Cooiisand Response: 

LOCAL -nn- Loop test successful 
nci ebf c ?'» e ; 

LOCAL -nn- Looij test failure 



o ODT 

The UDT coR»and is utilized to breaic into ODT during operations* 
For this to be effective Loth a CONSOLE terainal must be def ineo/ 
and ODT previously enabled using SET/ LEFINE server commands. Upon 
entering the ODT con At and/ ail operaticns will immeoiateiy cease/ and 
the ODT prompt Mill be issued at the console terminal. Any terminal 
or Ethernet traffic arriving dtring tre ODT session a ay be lost. 

Command Response: 

None (at the requesting terminal, if not the console) 

* (at the console terminal) 

Crror Responses 

LLC * L -nn- Qui rot enabled 
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o SHCW ALL CCNWECTS 

This command is similar to the non-pr ivileged SHOW CONNECTS coiaaiand, 
except that the connection status tor ail terminals is displayed. 
An example is shown in Appendix E.5. 

o StiGW COUNTERS 

The SBQU CtUNTERS conaand displays Ethernet counters and Server 
(LIT) counters. 

Exawp le : 

Command Response: 

Appendix F.6 provides an example of the SHOW COUNTERS display. 



o SHOW ALL HCSTS 

rat Shu* ALL tfUSli co&fcand enables tat privileged user to view all 
nost systems that are stored in the l?ost data base, instead of only 
those hosts which are accessible from the terminal. The display is 
similar to the non-pi ivileged HOSTS display. 

o SHOW SERVEF 

The SHG* SERVES coaaiisne displays server parameters and hardware 
status. 

Example: 

Pfc'IV_LCCAL> SHGfc SERVEfi 
Command Response: 

Appendix f.b provides an exa&pl* of the SHCW SERVER display. 



o SHOW TERWIfcAL n 

This co am; and displays terminal characteristics oi any terminal *n* 

(1-8) in the sache format as the non-privileged SHCi TERMINAL 
command* 
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o SfOP TEST TERMINAL {i|2j...J8> 

This command terminates any test activity generated by the TEST 
TEfcfclNAL n coaaand. It the test involved the LQGPBACK function, the 
results of the test is printed out on the privileged terminal. 

LXailsp ie? 

Pfi.I¥_LGCAL> STOP TEST TERMINAL 2 
Command Response: 

LOCAL -no- Test complete, xxxxxxx bytes written, xx error(s) detected 

Error Response; 

LOCAL ~nn- Terminal n not under test 



u TEST TEFKIKIL Clin ...SSI CVICTT! nn 3 LCCl*'? rnj CLCCF^ACfl 

This command conducts tne same terminal last as the non-privileged 
: i' EST TEnfc ih&L coflMiidt (?, except that any tersiinai way be tested. The 
terminal nust be in Lccai ^otie for this function to hork. 

If tne LOGiBACK keyword is given/ the external terminal loophack 
connector must be inserted into the specified terminal port. In 
tins case, the test pattern is intter to the terminal port/ then 
read oack and the data compared ior correctness. When the test is 
terminated/ a message indicating trie number of errors/ and nuaiber of 
bytes transferrer is displayed cn the privileged terminal. 

To terminate the test the STOP TEST TERMINAL command should be used. 

Ex a iap le : 

P£IV_LGCAL> TEST TERMINAL 5 i IDTB 132 LOGPfiACK 
Command Response; 
Hons 



o ZERO COUNTERS 

This command zeros all dynamic htfternet and server counters 
conta ined within EGSfclLOm The secones-since-zeroed counter is also 
reset. This coaiiaand cces NOT zero the up tio e or software status 
fields displayed in ShCK SERVER. These are zeroed by an INITIALIZE 
corns* and instead. 
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CoaasersG Hesponse: 



Hone 



3.3.4 Status Ard Error Messages - 

The following is a lull list of status and error messages, yhich should 
be self-explanatory basec on previous cescriptions and examples. For 
those messages where "(code xx)" is output/ the codes are explained. 

All messages have an associated MESSAGE CODE, to facilitate use in 

ncn-Cii gii t>h £pfc<*kir»g countries toge ther with native- language 

documentation. \t this time the error codes have not been defined, but 
are shown as *nn* in the wsessaye. 

3.3.4.99.1 Status Message Codes to be delired. 

Initialization Messages (with **e'1): 



LOCAL -no- Local, =?r e a service start, PO St ID ON Vx.y icaa.bbb) 



m a e i e I 



X 



external Major version number 



y 



External ^inor version number 



c 



aa 
bfcb 



internal Version status Code as follows: 

* V ' Release version 

*Z* Field test version 

*Y* L-ase Level version 

*X* Development version 
Internal software major version number (1-2 digits) 
Internal software revision level (1-3 digits) 



An example *ould be POStlDCN ¥1-0 (¥04-000) 



LOCAL -nn- Internal isefccry error in server parameters - 
Systen defaults in effect 



LuC AL I i; tern<*l memory error in t er a inai parameters 

Systeir defaults in effect 



LGCAL -nn- This terminal isay not function correctly 
Continuing operations 
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Logon Messages: 



LOCAL -nn- Local area service disabled 



LOCAL -jnri— fcrterirg Local «oce on terminal n 



Connection Status Messages 



LOCAL -nn- Connection to host XXXXXX established 



LCCAL -nn- disconnected from host XXXXXX 



■ GCAL -nn- Connection to host XXXXXX not established 
Host rejects connection (code xx) 



Code 


01 - 


Cede 


Z2 - 


Code 


03 - 


Code 


v 4 — 


Cede 


U b - 


Code 


09 - 


Cede 


lO- 


i# C u £ 


ll - 


Code 


12 - 


Cede 


13 - 


Cede 


14 - 



User requested disconnection 

invalid Message Foiaat Received 

Invalid Local Circi.lt Identification 

Invalid Ke&ote Circuit Identification 

Privileged disconnect or PCSE1DG& initialize 

'Ho host resources 

POSEIDON Circuit Timer too short 

User requested shutdown 

Host system shutdown in progress 

Fatal Coajsunicat ions Error (Invalid Slot) 

Illegal Service Class 



LOCAL -nn- Connection to host XXXXXX not established 
Host does not respond tc connect request 



LOCAL -nn- Connection to host XXXXXX not established 
Ccffiwun icatior error with host 



LOCAL -nn- Connection tc host XXXXXX terminated 
Host disconnects circuit (coce xx) 



Code 
Oout 
Cede 

Cede 
Code 
Cede 
Cede 
Cod e 



01 

€ ? 
04 

1 > c, 

V- ^ 

C7 



User requested disconnection 

In v«.l id message i-otaidt Heceived 

Tnvsiit 4 Local Circtit Identification 

invalid Remote Circuit Identification 

Privileged disconnect or POSEIDON initialize 

I ib e 1 iff it expired (from host) 

Pe transnsit liait reached (frorc host) 

Mo host resources 
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Cede 10 - Pt-SEIDGN Circuit Tiaer too short 

Code II - User requesteo snutaown 

Code 12 - Host system shutdown in progress 

Cede 13 - Fatal CoseiEunicatio rs Error (Invalid Slot) 

Code 14 - Ill egal Service CI ess 

Code 15 - Terminal not authorized to access host 

LOCAL -nn- Connection to host XXXXXX terminated 
Cowiiiunica tion error * i th host 

LOCAL -nn- Specified terminal supports local mode 

LUC A L -on- Connection aiieady esta&lisiieu 

LOCAL -nn- Continuing attempts to connect to host XXXXXX 

Connection Status Messages (no eerier tafcsr) *, 

LUC AL -tin- Ccnmunicat i crs with best XXXXXX lost 

Continuing attempts to re-establish communication 

LOCAL -no- Ccnmunicaticrs with host XXXXXX re-established 

LOCAL -no- Loyged off terminal n 

User Error Messages (Command is not processed): 

LOCAL -nn- Command syntax error 

LOCAL -nn- Privileged coma and or option 

LOCAL -nn- Keyword "XXXX" not known 

LOCAL -nn- Value invalid or out of I any t, "value" 

LOCAL -nn- Host XXXXXX not known 



LOCAL -nn- He connection established or requested 
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LOCAL 



nn- Terminal n is already privileged 



LOC A L 



nn- Terminal n not under test 



LOCAL 



■fin- Host 



is not available (code xx) 



Cede 00 - Hon t status unknotti 
Code 03 - Host is unavailable 

Code 06 - Host is unavailable (searketi lor delete) 



LOCAL -nn- Preferred host not defined 

LOC AL -nn- Parameter cannot be modified, connection established 

LOCAL -nn- Parameter cannot be dynamically modified 

LOCAL -nn- GOT not enabled 

Test Related Messages: 

LGC/IL -nn- test co&piete xx*xx bytes written^ xx ecrcr(s) detected 
LOCAL -nn- Lcoij test successful 
LOCAL -nn- Lccp test failure 

Pre-initialization Messages (with hcL)z 

LOCAL -nn- i ARMING — Local area service ending in UhU minutes 
LOCAL -nn- Local area service eno 
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3. 4 KICPQCLiDE IDESCx? IPT1GN 



The POSEIDON capabilities described in the previous sections utilize 
software that is dowrl ire-ioaded following successful initialization. 
This section descrioes the ROM-based microcode which handles the 
downline-ioaci operation end required lew-level Ethernet maintenance 
services . 



3.4.1 Status Reporting functions - 

Upon each POSETDHN initialization/ power-fail or fatal error, the 
RC^-bastd uidyf;Ootic sell- test executes tc verify the Poseidon hardware* 
There are three basic results of the self-test, which are reflected in 
the state of the POSEIDON front light as follows: 

o Unit is fully operational (light constantly on) 
o Unit is partially operational (light clinking) 
o Unit is not ot»*»ra t ional ( 1 inht off) 

The diagnostic status is reflected in the light approximately ten seconds 
following the initialization. It the light remains oft/ the unit 
requires service and will not tunc tion la cay way. 

The POSEIDON microcode provides a mecharism fee reporting non-fatal 
errors and downline load status to the user folloving initialization* 
This is done by entering one or two carriage returns on one of the 
terminals connected tc the unit/ and observing the message(s) displayed. 

The first message identities the PGSEIBQfi end its Ethernet address: 

LOCAL -nn- Initializing POSEIDON 'Ether re t_address* 

It the front PLStlDQfl light is blinking/ the following message will 
appear : 

LOCAL -nn- EARNING -- Ncn-f atal hardware error detected 

Server status xxxx/ teminal status nan nnn nnn rinn nan ana nan ana 

where 

xxxx is a fci taap code indicating a aca-iatal error condition 
which affects the server as a whole* Each *x * a. ay be a 
zero or one, a cne meaning that the condition is true* 

< io ifcii. to t i <j i 1 1 the codes ate; 

o Checksum error in server parameters, using system 
cle leul ts 

o til Port hardware error/ exterral loop-back test failed 
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o ui Port hardware error, no neartoeat detected 
o Checksum error in diagnostics parameters 



nnn is a ultra ip code indicating a nen-tatal error condition 

which affects a particular terminal. Each *n* aay be a 
28io or one, a cne meaning that the condition is true, 
t ac h group of 'nnn* represents the status tor terminals 
1 to 8 f roa left to right. Hi thin each group, the codes 
are (froa left to right): 

o Checksum error in terminal parameters , using system 
defaults 

u naid error on terminal port, tort disabled 
o Dynamic erioi on terminal port/ port enabled 



The microcode will similarly provide status information as to the 



— : r o f r rt -f- - •♦• *• * n H r\ y r- 1 j -> " * j ' ■ ' - J- * : £* ( , _1 U I ■ . 

messages will appear in a normal load procedure: 



-t enc e j 



LHCAL -nn- ''-2 i t i n g lui i»oge loao 

LOCAL -nn- Loaning trow host *£ tnerne t_cdiir ess 



Following a successful load, the operational L AT software gains control 
and starts tecminal server operation. If an error occurs in the load 
procedure trie iciio*ing message occurs* 



LOCAL -nn- Load failure, protocol error 
LOCAL -nn- Load failure, timeout 
LOCAL -nn- waiting for image load 



ii no host volunteers to load the unit, the 'Waiting for image load' 
message will be repeated at intervals oi 30 seconds, and the unit will 
attempt to load indefinitely. Reloads are also attempted if downline 
load fails. 



At any tinse following self-test execution, and prior to the completion of 



downline loading, a user may 
typing in a specific control 
re- initialization takes effect 
prevents unauthorized users from 
normal dovnl ine load procedure, 
is successful, re- initialization 



request r c-in itia I ization of the unit by 
code (ccntrol/P hex 10). however, 
upon downline load failure. This 
re-mi tiaiizing the unit during the 
It con trol/P is typed/ and downline load 
will not occur, out may thereafter be 



requested using ttie Pr iv l leged Local ^cde interface. 

Trie Control /P must oe typed af ter the initial carriage return for correct 
interpretation. This function is pre viced as a means to re-ini t laiize 
the unit in the absence oi software without removing the power cord. 
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3.4.2 Downline Load Function - 

The POSEIDON aiicroccde contains a tertiary loader program to load the 
entire operational software iasage into aeaory. The load procedure 
utilizes the standard Maintenance Operatiors protocol and requires that 
there be at least ONE active Phase IV DLCnet node on the Ethernet* 

The POSEIDGN requests a specific load image file from the host, its naie 
being stored in permanent memory* This iaage filenaae defaults to 
PS0801ENG. SfS, but »ay he changed by the terminal manager using the 
'UEFINE SERVER SQFTfc ARE_ID * connand in Privileged local node. This 
feature facilitates the img lemetation cf foreign language support. 
Details of the couiiline-load function are provided in Appendix I. 

It the diagnostic status reports an externcl loopback error condition, 
the downline load will not he attempted* The following message mill 
appear instead: 

LOCAL -fin- Iffiage lead net attempted, netyork cowuunication failure 

This message moic ites that the PLStllGi* ft £S no Ethernet access, ana may 
he caused by cab I inq or t r ansrei ver rro t-l*?**?. fcllowirs this ir essage, 
control/P may he entered to re-i n it ia iize the unit, and cause a 
subsequent downline load. 



3.4.3 Upline Dump Function - 

The POSE I00N a ay be requested to upline duirp its memory tc a host system 
upon a system crash. This may be specified using the SET SERVER BUMP 
ENABLED coffijsaiid in privileged aaode. khen enauled, and a system crash 
occurs (except one caused by the fcatchcog timer), the POSEIDON memory 
wi 1.1 he dumped to a dump volunteer host. The foiloying messages will be 
printed out on the designated CONSOLE terminal (if any): 

LOCAL -nr- Fatal Bugcbeck at xxxxxx, Sf-xxxxxx, SR=xxxx, TP=xxx 

LOCAL -nn- Waiting for isage duap 

LOCAL -nn- Dumping to host 'Ethernet address* 

The Fatal Bugcheck message displays the address of the instruction 
causing the clash, the stack pointer ( SP) and Status register (SR) at 
that tiffie, and the crash type (TP). The crash types are defined within 
the listings of the code. 



PQSEiDQN Software Specification - 
Maintenance functions 



CGI*P A^l V 



CONFIDENTIAL 



Page 55 



3.4-4 maintenance functions - 

Tiie POSEIDON microcode will support the lolloping low-level maintenance 
functions, which are initiated iron* a host system; 

o For yard Message 
o Reply 

o Identity-self function 
o Read-identity functicr 

These functions satisfy the mmifDUfli network naanageiient requirements for a 
DIGITAL node on the Ethernet,/ and are described in section 3.1.17. &ote 
that the POSEIDCM- initiated hoop requester and Read-counter functions are 
not supported cy the roicrccoce/ but are supported by the downline-loaded 
operational software. 



3.4.5 Uniine Debugging Tool (GOT) - 
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help diagnose any system problems that nay occur during POSEIDON 
operation. This tool is a runcticnai sunset or the lAS/KS.X~Ilfc GDI, and 
a -u~ sen Led in th* "r CS£ IDGN f>i agnostics Online Debugying Tool" 
specification. The ODT is designed to be used by Software Services, 
Field Service or other specialists hi ih knowledge of the sof tware 
residing in the PCSEISOfc* 

It is ay! expected that Oui will utiiizea by custoiers/ and its operation 
(and the privileged iscce comisands that invoke it) is not descibed in the 
normal POSEIDGi* docunsenta ticn set. It is, however, described in the 
POSEIDON technical manual. 

furthermore* it is expected that the GDI function will only be used when 
tracking down problems/ and will not be enabled in the noraal mode of 
operations. The specialist must enter the following coaaands fro© 
privileged locai rode before GOT can be utilized* 

PR IV LOCAL> SET SEUV&R CONSOLE n 
PRIV_LGCAL> SKI SERVER COT ENABLED 

where : 

n is a POSEIDON terminal port lumber (1-8) that 

id to be used for the GDT console. 

The spec ri iec terminal must he cont igur ed accorcing to its permanent 
terminal par a^eters btoieJ ii* r " V . .. !»cn C£T is enabled/ it may be 

activated in one of trsiee ways: 

o Upon entering a privileged ODT commaac. 

o Upcit a system crash (f oliowing optional Upline Dump, hut prior to 
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sei f- test ) . 

o Upon re-initiaiization (following Downline Load, but prior to start 
of normal operations). .Note: GDI will ^OT be enabled after a 
Power-up, but after a software initialize only* 

when UDT is entered, any ODT command may be given (see ODT 
Specification). If the *Cd* coaasnd is given with no PC, execution 
continues at the following places, cependirg on why ODT was activated: 

o Upon ODT coiiand/ or ODT breakpoint - At the next instruction 

o Upon systeir crash - At the HGM-based Self-test 

o Upon software initialize - At the start of normal operations 

The ODT operation, SET SERVER CONSOLE anc GDI cosaands will not be 
described in the noraal FCSEIBGK documentation set. Information 
regarding ot)T operation will be provided to Software services and Field 
service, and to certain customers as the need arises. 



4.0 PUBLICATIONS 

The software publications supplied with tuLtluQU are targeted lor t*o 
a? a in audiences: the Terminal User and the Terminal Manager (see Section 
2.1). It is expected that these two groups of people will be located 
general ly in the vicinity of the 1 GSEID0& unit, and that the 
documentation will reside there also. 

For each terminal usee, a PCSE1D0& USER'S CARD is supplied. This card 
contains a siuB&ary of local mode operations and commands, and is expected 
to cover over 95% of the features that a non-technical terminal user 
you Id ever need. 

One POSEIDON OPERATIONS GUIDE is provided, which explains all terminal 
server features and more detailed operations. It is expected that this 
document is located with the Terminal manager, also in the vicinity of 
the irOSEIDON unit. If a terminal user has a problem (or needs »ore 
detailed information concerning operations), he/she may refer to this 
manual, or call the terminal manager for assistance. 

One POSEIDGfi SOf'TfrARE INSTALLATION GUIDE is provided, which explains the 
software installation process for each type of host system on which the 
software is expected to reside. This manual is expected to be located in 
thts t'Uiiiiboioii i>i the iocu nos t oy&tew ifeducgec , ana nut ne locatea in tne 
area of the PCS* ibOfc unit. 

Trie contents of eLCh jcanua i is as f ol lows: 

o POSEIDON UbEk'b CftHD (fa supplied per F-CiSElDOfc) : 
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- Local f^ode Operation Overview 

- non-privileged CoMand Susnary 

- Status and Error Message Su&Hary 



o POSEIDON OPERATIONS GUIDE (1 per POSEIDON): 

- Description of all Terminal Server features 

- Local Mode Description 

- Non-privileged ccuwand descriptions/ including responses 

- Piiviiegeo command oesci ip t 1 ons/ including responses 

- Maintenance Operations 

- Ecisic Tr oubieshoo ting procedures 

- "tctui end :: r i c l >'oz2Z a e^ D c s c x 1 k 1 1 c ;. 



o PCSFIGON ^C^THamE .INSTALLATION GO IDE (i per optional software kit) 

- Software installation Procedures 

- Installation Verification 

- Software Update (Autopatch) Installation 

Iniormation of interest to an overall network manager, including a 
description of the LUX architecture, saessage formats and network 
troubleshooting procedures, is supplied in the documentation set tor the 
LAT nost support, ana is not packaged with POSEIDON. 



5.0 PACKAGING 

The PGSE.ID0& software resides or, a LOAD LOST system, ard is downline 
loaded via the Ethernet upon every POSEIDON initialization. when 
POSEIDON units are ordered, the custoaer/ salesman should determine the 
number ard ty pe (s) cf load host systems. Mi th snail .Ethernet 
coniigur at ions, one or two load hosts may suffice. iith larger 
imp I am en tat. ions, more load hosts «ould speed the downline load process. 
* rule cf thun:t Eight be tr at ONE lead hos t is required for every 10 
POSEIDON units installed, ^ ius ONE spare. A load host »ust be configured 
*i tn ehdse [.V D tCnet , ana have a DECne t license. 

ashen orcering PCS E I DON hardware units, the appropriate POSEIDON software 
neess to De specified. It is also i^por tant that the LAT host software 
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(in the form of a host-resident driver cr LaT host server) be considered 
at this tiaie. tor licensing purposes, the loiiowing applies: 



o DM PC0EIBCN 
ordered, and 
execution ci 
co&es with 
provided fcr 



software license is supplied for each POSEIDON unit 
is included in the basic cost. This license allows the 
POSEIDON server software on the hardware unity and 
a 9C-dav *arran ty . The following documentation is also 
each unit! 



- 1 POSEIDON Site Ireperation and installation Guide 

- 1 PCSEIDGfc Operations Guide 

- 8 POSEIDON Users* Cards 

h POSEIDON sot taare kit may be purchased, which includes 'binaries* 
supplied on an appropriate disk/ and ail software-related 
documentation including <* 50ir"T* AhE IMttkhL&'l IGk GUDE. This kit idy 
be loaded onto any nu»ber oi DECnet load host systeas. 

ubi t L AT host software license »iust be purchased for each host that 
intends to support the PQSEIDCf* terminal server. Right-to-copy 
licenses are available tor this software. L AT host software and 
'lo cvt *? r.t ,?t i c r ^*L'5t « crc?er€*1 ? sf i p?r?*t* > Iir?e it / fln<? f^iy b<* 
shipped with the POSEIDON, or ordered seperately frosc the SDC. 



6.0 INSTALL Afc 1L1TV 



The POSEIDON 
auto&a t eo 



in 



software is designed to be customer install able, and fully 
The installation procectue will be initiated by one or two 
commands entered at the load host system console, and will be described 
a separate Software Installation Guide. 



All standard 
be applied. 



installation procedures for layered products (if any) will 



Updates for both 
the saie manner 
instructions are 



POSEIDON software will be supplied in Autopatch kits in 
as are updates fcr other layered products. Installation 
provided in the kits. 



7.0 EASE-GF-USE 



he Local Mode user interface has been designed for simplicity, 



cowpat ioiii ty 
Voyager). All 



with o trier OiGiTaL local area terminal servers 
coiruands are in an feng IS sh-Iike format/ 



and for 
(such as 
without switches 

and other unusual punctuation. Post access is by name (rather than 
F.the rne t-i d ) . * twc-ieve 1 BELP facility is supplied/ which shows all 
available comaands, and ail options for. each coffiisand. 



The capability exists for a Ter&inal f^anagtr to define a PREFERRED or 
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DEDICATED HOST lor each terminal, and to set up perianent terminal 
characteristics* In this way/ a user may sccess a terminal without any 
knowledge of a Local recce interface, since the terminal will be 
permanently connected to a host system. 

for the Local Mode user requiring more flexibility/ cotiands exist to 
display a list of available hosts, set and show dynamic terminal 
parameters/ and to connect to and disconnect from a specific host system. 
It is also possible to run a terminal test fro® a local terminal* 

The Privileged Local Node interface has been designed for siiriplici ty, and 
is specialized for the PCSEIDGti/LAl environment* A HELP capability also 
exists for Privileged commands. 



8.0 PERFORMANCE 

6.1 Response Time 

POSLIDQai has been engineered as a hign-per lor iance terainal server 
?;>ro<itic t, ^r> !*» to provide *I~*^se^ teririra is 2it? the throu^h^ut an:! 
response time expectec cf ? locally connected terminal, even under worst 
case conditions* 

Character-echo lesponse tine is a critical per forwance attribute, and in 
the case of POSfcilDLft, is highly dependent on the value ot the CIRCUIT 
TIMER* For noraal interactive functions, in which the host terminal 
class driver echoes all input characters, the character-echo response 
tiise will average 0.5 ti&es the circuit lifter/ plus a saall propagation 
delay. 

With the circuit tiiier set at the reconvene 80 bis value, this response 
time is between 40 and 5C as. Although this is numerically auch slower 
than a direct connection (such as a D211), a 50 ras {1/20 sec) delay is 
not noticeable to a huaan operator. In effect, the 'apparent" response 
time is the sane as that of a local connection. 

This response tiase will UQ1 degrade upon maximum throughput through the 
se rver. It way degrade (as would a local connection) if a host system is 
over loaded. 

For application programs using the r eac-with-no-echo functions, the 
character echo response time will average at least 1.5 tines the circuit 
tiffler, plus propagation delays plus application program delays, with the 
recommended circuit truer of 80 ps, this tiiae will average at least 120 
ins. For certain applications/ such as EDI, which issue multiple write 
I / * s ioc erjofi ciicr ac ter typed, the response time- may be longer. 

ktien a character is typed cr a biocK-ccde terminal, the typed "echo* is a 
local ecrio. fco nost processing is involved. The response for a whole 
block of data sent is dependent on the application processing tioe and 
the host-POsE 1DLN throughput. 
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8.2 Server Throughput 

Server throughput is the ruaber of bytes that the server can process in a 
given aicount oi t lire, and may be expresses in terms of bytes/second. It 
is the GOAL of POSEIDON to be able to drive full-duplex output and input 
at 9600 bps (approx 960 bytes/second) on ail terminals* 

This performance is HIGHLY critical on various code paths within the 
POSEIDON software, and actual performance characteristics will be defined 

iinrir ("nitrnJ «ti /in r\ f -fr H i <=■ i~ fs t*. r% »"i> r «r f nii^ lit oi c citflnoctt; that ♦" H •» rt n -» 1 
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will be met. 

POSEIDON Mill accept line speeds of up to 19200 bps, but bill NOT support 
sustained input at this line speed. Terminals must not transmit »ore 
than 960 characters per second at 192CQ hps, otherwise the server may 
outi.idtt! and ui-ti. overruns may occur. In addition, even moderate bursts 
of 19200 bps input may adversely affect terminal output. It is therefore 
HIGHLY recommended that a line speed of 19200 ops be used ONLY in a 
human-speed input environment. Sustained output at 19200 bps is 
supported. 



3 Ethernet Utilization 

Ethernet (Nl) u tiiizat ion i£» an iapor tant consider ation lor determining 
how many P0i»E IDO'Ns, and other processcrs, can be supported on one 
Ethernet. 

The nature of the L AT protocol is such that Ml utilization is lowest when 
the number of connected hosts is small compared tc the number of 
connected terminals, and highest when the nuaber of connected hosts 
equals the number of terminals. The HI utilization is highly dependent 
on terminal speeds, and also somewhat dependent cn the Circuit Tinier 
value. 

The following table indicates the worst-case scenario of 9600 bps 
full-duplex siffitltanecus irput and cutput (or 19200 bps output only) with 
various numbers of terminals and hosts. 

The "UAm DATA* utilization is simply the percentage HI usage that would 
be required tc trarsfer 1920 characters/second/ terminal across the 
Ethernet with nc protocol overhead. The I0SEIDGN utilization includes 
the L AT protocol overhead, with two Circuit Titters values of 80 as and 

30r?s. 

The t ei c«.n tage,u r cpr e^en t the actual utilisation diviued by the 
theoretical H'axitauw for the Ethernet of 1. 25 kbytes/seconds (10Mbps). 
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Numner of 
Terminals 



dumber of 
Hosts 



Nl Utilization 
^A«l DATA 



U til 12 at ion 

SOois 



POSEIDON 
30ms 



0.15% 
0.61% 
0.61% 
1.23% 

•t -> -~ a 
i • AO « 

1.23% 



0.72% 
0.88% 
1.401 

■% tz ca. 

1.76% 



0.32% 
0.86% 
1.27% 
1.57% 

2.531 



These are 
P 5 tj 1 D C t-i • 



the yorst-case 

In normal 



utilization requirements that may occur fcith one 

usage, terminal traffic yill probably be 

intermittent/ terminal speeds may be lower ^ and other factors comoine to 
make the actual hi utilization jBUch lower tn an indicated above. 



b.A host Perior&ance 



A PUSclLLfc imy i em dilation has the potential ox utilizing less nost Ctii 
process in 9 than trao it ionai asynchronous interfaces such as the DZ11 • 
this is because in one host interrupt/ an entire L AT buffer/ possibly 
containing data lor many terminals* may be serviced. The 0Z11# by 
contrast/ requires a separate interrupt loi each character processed. 

The actual amount oi host processing depends on iactors such as Circuit 
Tiaier value and i/G length. Also critical is the amount ot processing 
per single interrupt (which is Many times lore than that of a DZ11 
interrupt). 

Mith these factors in mind/ the minimum expected performance goal of 
PuSElDGai (tilth respect tc host processing) yith recommended parameters is 
to match that ol tae CZ11* It is expected that under most circumstances/ 
host CPU utilization yill be less yith POSEIDON than with the DZ11, 
especially when large amounts of terminal traffic is involved, resulting 
in more host compute pot»ei available lor application processing* These 
expectations arc basec on an existing LAT prototype system. 



Actual performance measurements will be 
that performance characteristics may 
expectations accurately set. 



ffiaae after implementation, so 
be accurately defined, and user 



Ail performance estimates are made on the assumption that the error rate 
ovet the ttnernet is loy, and tnat the ttiiernet (and hosts) have light to 
moderate loads. In heavily-loaded hosts a nd networks/ the overall 
response- t ime and thrcughpcu t performance (as perceived by the user) yill 
be *or se than stated above. however/ a similar performance degradation 
youlo be unserved on any terminal /host system under the same 
circumstances. 
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9.0 RFLIAB ILiT ¥ 

Reliability is of primary importance ir a product with such high 
visibility. An extensive internal and field test program will be 
undertaken prior to snipasent in order to eliminate all fatal software 
errors, and protocol violations. Shipment will not take place if any 
fatal conditions or protocol violations occur without resolution. 
(Category 1 errors). 

Category 2 errors are defied as ssajci errors which do not cause a crash/ 
but result in the non-f unctioning ol majcr elements of the software, or 
cause serious perioraiance problems. Shipment will not take place if any 
category 2 errors are known. 

Category 3 errors are defined as miner errors/ resulting in the 
iion-I uiictiuiiiiiy (or ym tiai I unc t ioniiiy ) ol minoL elements ol the 
software or errors causing aincr performance degradation. Shipment will 
not take place with any more than two (2) such known errors. 

Category 4 errors are defined as totally cosmetic errors* with no impact 
on functionality ana pec lor nance. Shipment will not take place with more 
tn^n Hvf ft?) ««!ch *rovr» errors. 

Category 5 errors are suggestions ar.d documentation errors. There may be 
any ntrirber of suggestions submitted, but shipment will not take place 
witn la or e tiian rive (b) knemn docuajen tatioi errors. 

Since PGSEIDOM contains a stand-alone software system, the following 
broad categories of detectable errors, ana PCSEIDOf* responses, are 

defined : 

o Fatal hardware Error, determined by diagnostic self-test. The 
POSEIDON unit will not lunction, and the hardware status light will 
remain oft. k unit replacement is recuired for recovery. 

o ^on-fatal hardware Error. The hardware status light on the tOSElDON 
will Hash, and an appropriate value will be placed in the hardware 
status indicator. Hardware status may be displayed using the 
privileged 'SMC'M SERVE K* command. The unit will attempt to function 
normally with a non-fatal hardware error. 

o fatal Software Frror, caused by a fatsl software bug or hardware 
error in server. A crash routine y ll i place a value in the software 
status indicator, optionally upline duap the PCSEIDOK memory, then 
initialize the server. This vaiue may be displayed using the 
privileged *SH0w SERVER* command. If the software error was caused 
by a fatal hardware error, the initialization will be unsuccessful, 
arc the r Lbt. \ bLti unit will net function. 

o LAI Protocol hr ror, caused by a soityare bug in server or host. An 
error message will be displayed cn all affected teraina Is, the 
virtual circuit will be placed into the halt state, end all 
terminals will be disconnected. It Autoconnect is enabled, attempts 
to reconnect to the saae (or a different group) host will be made, 
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otherwise Local fcode till ce entered. 

o LAI Tifiieou t Error/ caused by a problet in a host systeau After 10 
unsuccessf y 1 retries, an error message will be displayed to ail 
a fleeted terminals. 

If AUIQCGNfcECT is disabled, a message is displayed indicating that 
ccRiiBunicatioD with the host is lest. riowever, PGSEIDON will atteapt 
to re-estcolish coaiffiunications, unless and until a DISCONNECT 

If AUTUCOHNELT is enabled, the connection is taken down, and a new 
connect request is issued. II the specified host name is a GROUP 
naase, connection to another host in t re group is atteapted* If the 
specified host name is a unique name, connecttion to the same host 
is attempt fed. The au toconnec t aiechaaisw may be stopped by entering 
local mode. 

o User Input Error, caused by a user entering invalid input in either 
Local or Console i^cce. An error message is printed out, and the 
entire command ignored. 

o Oa ta Over tun *:rror, caused by a«ore characters being input than can 
be accooaocQted in a L AT buffer • This error can only occur if input 
tic* control is cisab led, cr if the terminal has ignored the XCFF 
character sent to it when the builer was lull. The character is 
discar oec, and op tionally a btL i^eeg) code is output to the 
terminal. 



10.0 fcAlirfTAlSAtilLriV 

Haintainaoi lty cf the PGSEIDCN software will be enhanced by the following 

pr ov is ions : 

o The PCSEIOCN Sof tware Installation Guide will describe how to 
install updates of the software via the Autopatch mechanism. It 
will also briefly reference the VMS/RSX EOT utility (described in 
the operating systei* cocuaenta tion), which nay he used for updating 
of the PGSETOON software iff age hy Software Services or the customer. 
Patches may be supplied by telephone, or through publications such 
as the Small Buffer. 

o Updates will be supplied in standard Autopatch kits for layered 
products. The release of the Automaton kit will be controlled by 
the Outi'dtiist ays tei*. hie entile t-o&eioor loao image will be 
rep \ acert ty Autopatch. This wi 1 1 ai irost certainly invo lve just one 

I 1 1 i: . 

o The Server Software will be & odui ct izec, with clearly defined 
interfaces . ^ocuies will have cle«rly del ined areas of interest, 
and will net perform tasks outside of those areas of interest. All 
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modules and routines will have their functions defined in block 
comments prior to the actual code, 

o Microcode LDT kill be available, and this &ay be enabled from the 
privileged terminal. On-site personnel may utilize this QDT 
capability, or it aay be utilized reacteiy over the telephone (for 
the jsaodero control version of Poseidon). The OCT capability kill 
allow examination/ modification of memory and setting of 
or eakpoints. 

o An Upline Duibp capability kill be p to video's and at ay be enabled from 
the privileged terminal* The dump yill occur upon any POSEIDON 
system crash, except that caused by the hardware watchdog sanity 
timer, this dump may then be later examinee to determine the cause 
of the crash. A dumg formatter prog ran is being considered for 
release at some time following the initial Pii^EiiiUl^i release, and 
yill be implemented or a time-a vailabie basis. 

o Non-fatal error conditions will be counted, and display able using 
privileged local mode commands. 

w TV.c Server Software kill te completely comntentei, to current 
software standards, and all documentation conventions will oe 
foiloyed. Following iapie&en ta tion, c Maintenance guide yill be 
y.r i tten explaining Data structures, logic f Icy, error handling etc. 
This «ill De compiled trom existing design specifications, cosaents 
in the code, and new descriptions. 



11.0 MAINTENANCE {PRELIMINARY) 

11.0.99.1 Maintenances Final strategy to be defined following Phase 1. 

Software maintenance for PCSEIDGN will be performed by the Distributed 
Systems software maintenance group. Customers may report problems via 
SPR service or through a telephone hotline. Customers and/or Software 
Services may utilize the GDI interface to more specifically diagnose 
problems. Use of this tool will be co-ordinated by the 
development/maintenance team in Software Engineering. It is MOT a goal 
for Software Services or the customer to independently utilize DOT beyond 
obtaining a register printout or memory dump following a system crash. 
Neither software services nor the customer yill normally have access to 
the source coce. The software main te ranee team may utilize the GOT 
interface directly through a ceodea. line for the modes* control version of 
Poseidon. 

It is expected that the maintenance effort for POSE IDC N *ill require 0.5 
persons for the first full year f ro» F CS f cr POSE ICON software. 

The maintenance group will publish patches as necessary in the iollowing 
publications: 
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o Snail buffer (for VfcS and HSX load host systems) 
o Large Lufttr (lor TOPS-20 load host systems) 

Maintenance releases *»iii be made, if needed, at cjuarterly intervals for 
the first year following FCS. Patches yill be published in 
weekly/aonthly articles for wore immediate application* The utility 
'PUT* iray be used to apply patches. 

Patches applied to POSEIDOfi yill have to be co-ordinated with patches for 
the L At host support* It is therefore planned to ship Batching patches 
tor both sides cf the protocol* 

Major enhancements tor the POSEIDON product nave not been defined/ but it 
is expected that enhancements will occur over the life of the product. 



12.0 COMPATIBILITY 

POSL1DCN, and the software which executes tpon it# is a new product. Its 

itnctKi. i- to dct ^ teraincl reiver cn an Ethernet local area 

ike tyor k . 

The ; -LU : ii-i>^se'i 'Voya-Qei* L-iotiuct is a 32-leiiPinal, DECne t-coapatible 
terminal server on an Ethernet local area network. To facilitate the 
possible use of both servers in the same ervir cnsient, the non-privileged 
PUSEIDOfs Local rode interface and Voyager are coffipatiole* 

The POSt luufc rnviiegea »oce interface, being heavily involved with the 
L AT architecture and having its own maintenance functions, has its own 
interface. This interface is patterned after the EECnet Network Control 
Program ( ^ C P ) , although hy necessity there are aiany differences. 
LAT-related privileged commands are compatible with other LAT-based 
terminal servers. 

POSEIDCh sof twaie adhetes tc the Local Area Irarspcrt (LAT) architecture 
specification, and is designed to operate with any system that supports 
the host implementation oi L AT, with tne Interactive Terminal service 
class enabled* 

FOSEIDCM adheres to all requirements cf the Ethernet version 2.0 
specification, and implements the k£PL^ and FOR^AHD MESSAGE network 
management functions cefineo therein* The Ethernet physical link and 
data link layers are performed exclusively by POSEIDON hardware* 

PuShluCN aireies to ail requirements of the DIGITAL hi node architecure, 
ai.cS siii „ ci tj tf t LLCP SERVER, IDh NT it v- SELf , Kt AO-lb SfitlTY and 9tkb 
? r l\7^. iunctiCf.^. mSEirCH also imp 1 erne rts the optional LOOP REQUESTOR 
functions, i- met network management is locally initiated. 

Except loi the doyniine load/ypiine dump lunc tions, POSEIDON does not 
interface aifch DF.Cnet (or any other network protocol), but nay function 
in both DaCnet and non-DECnet host environnent s. PGSEIDGN is compatible 
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with C£Cne t-sufpl ied host naaies, and OECntt-aooil ied Ethernet adoresses. 
The L AT software in the host system is responsible tor reading the OECnet 
host name and Ethernet address, and respcnsible for sharing the MI port 
driver kith DtCnet. 



13.U EVOLV ABILITY 

The current piers are to ship PCS£lLGh software as an English language 
product. Software engineering does not intend to implement foreign 
language support* but has provided the hooks to make this possible. In 
particular, all hard-codec English-text has been consolidated in one 
section of the program, Kith a conditional assenbly parameter. Space has 
been reserved 1 cr an increase in code size- that night oe experienced when 
a language conversion takes place. In addition, the capability exists to 
define an alternate lead image file tame and the format of the existing 
name lakes into account the language used. 

If a language yfich requires an ti-bit char ec ter set (in local mode) is to 
he i mp leper ted, certain <ecticrs of th* T<*rrir?l *crt rro^ule will require 
aioditication. These sections have also he identified by (another) 
conditional zsscmblj parameter. 

I'ae node w control version ci Poseidon has already been designed to he 
use a yith wo^ t r.ur o^ean OiOGeBis, as pel ULC standard 052. 

The POSEIDON code yas modularized fcr possible inplementa tior< on future 
product?. The Protocol and User Inter lace module were made (virtually) 
indepedent of the hardware environment, except for the CPU type. The 
terminal port ncduie and N I port nodule are hardware dependent, but their 
interfaces with other modules are not. 



14.0 COSTS 

POSiilDOiN Transfer costs are based upon the cost of hardware and 
manufacturing. The cost of producing software documentation is included, 
but the software development costs are not. Software media is an 
optional itea, which is ordered as a line it en (at media cost). 

Excluding the software media cost, the POSEIDON will transfer at a price 
ot about $500 lor the non-aioden version. The aiocei control version will 
transfei at about $dU0. 
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15.0 TIMELINESS, CONSTRAINTS AND TRADE-Qf'iS 

The POS£IDO« product must be ready tc ship in Ql 1985. The software 
development schedule, risks, dependencies and requirements associated 
with the development effort are defined in the PQSEIDCN Software 
Development p 1 a r « 

This section defines contraints and trade-offs that may affect 
implementation of features/performance that have been described in this 
do*" ns'i e n t * 



The sain constraints affecting functionality concern memory utilization 
and execution speed of the FLSEIBLN software. 

Preliminary analysis has been performed on execution time based on an 
7*35 ULz HC680C3 ^toce^soi/ «hicn indicates tnat tne per lormance goal of 
96 CO bps full- duplex will be met, if an appropriate Circuit Timer (80 ws) 
value is specified. Use of shorter circuit timers, exceptionally heavily 
Ethernet traffic and otner considerations may affect this throughput 
goal. Performance will he measured icllcfcirg implementation, and 
supplied kith the final documentation, wo dropping of functionality is 
<»i r»t>n**d to «»nh ?prf» p * r f o r m rfnc e • 

The reac-oniy memoes available for the PGStlDCN initialization microcode 
has been limited tc t KB/ and the current estimate is 6 XL. The 6 K3 
1 lmi t iuust not ue exceeded. The following is a list at trade-offs for 
the PGSt luLfr Microcode, if the memory allocation is not sufficient: 

o Diagnostic Status reporting mechanise will be abbreviated. (Message 
codes instead 'of English text). 

o Controi/P re-initialize function will be eliminated. 

o Autobaud function will be eliminated, and replaced with output only 
with terminal parameters stored in KAH. 

o Tex tiary Loader kill be replaced with a Primary Loader (or seconuary 
loader ) . 

The downline loaded software must fit into the 32 AB allowance for the 
non-modem control version of POSEIDON. Aacitional Code and RkM estimates 
for modem POSFIBON and reverse PQSFJDCfi mist not exceed 12 Kfi. The 
current estimate for the non-modem control version of POSEIDON is 26.25 
KB. The following features will be traded off to ensure adherence to the 
32 h& limit: 

o The undocumented ttGftllTGR command (which presents a continuous SHOW 
uispi ay lot 'v 1100-coftipcs tioi e terminal would be dropped. 

o Local r'ode support for VT1C0 escape sequences, and terminal type 



H i« O 



I* wou i d be or oppe d 



o Fuii two- level HLLF faci lity (compatifcle with VAX, RSX etc) would be 
replaced by a HELP ' facility containing the following capabilities; 
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!i E LP 

t\ t L F PRIVILEGED 

HELP TEfcMl&AL PARAMETERS 

HELP SERVER PARAMETERS 



o Specification of Server Hame and Location would be dropped. 
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APPENDIX A 
DRAFT SOFT* ARE PRODUCT DESCRIPTION 



PRODUCT NANE: PCSEIDGN Version 1.0 

Ethernet Teriiinai Server 

DESCRIPTION; 

POSEIDON is an Ethernet-based Terminal Server product which alloys 

up to eight interactive terminal users to communicate with host systems 

on the Ethernet* The software is downline loaded into the POSEIDON Terminal 

server hardware irom a VAX/VKS system running CECnet/VAX. Hhen loaded, 

terminal users nay access i thernet-based licst systems kith W AX-11 LAT support* 



Features : 

h LOCAL &GDE interface is provided, allobiir.$ a Terminal User to: 

u CQ!>NLCT to any authorized hast system on the Ethernet 
o Oispiay a list ot avail able hosts 

<j Sf I 'apc S«l"» te c r inei i^ian^tfecs, and per^ane rt i y retain them 
o TEST the terminal for correct operation 

A privileged LOCAL fcGDF interface is proviced, alleging a Terminal Manager to: 

q CuNNcCi any terminal to any authorized .no si system on the Ethernet 

o SET and SHOW any terminal's parameters, and permanently retain them 

o SET and SHC the Terminal Server parameters 

o SHOW Terninal Server characteristics and counters 

o Perform Ethernet maintenance functions 

ft HOST feGDE inter face is provided, thereby a Terminal User can communicate 

with an authorized host system* 

Support is provided for the following DIGITAL terminals using the EI A RS-232C 
CCITT v. 24 serial line interlace: 

VT100, VT101, VT102, VT125, VT131, VT180 
VT50, V152, VT56, VT62, G1GI 

LAI 2, LA34, Lft36, L A 3 b / LA50, LA10C, LA120, LAlfoO 
VT20C, VT22G, VT24C 

Support is provided lor tne following terminals, khen in terminal emulation 

h a iNbUk-iUO, DKCmate-I I, PKO-32S/350 

Supported line speecs are from 50 to 192UC ops in Line Mooe., and from SO to 
96C0 in Biock fcode {¥1 12S/G 10 1 )* 
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The PQSfclDON Terasina 1 Server img leients th€ Local Area Transport ( L AT) 
architecture between server and host. L AT support is also required on the 
host systems to be accessed* 

Other features include: 

provides security against unauthorized access to any PGSEIDCN functions 

o Full XGFf/XON t iota control between terminal and Terminal Server, which 

may be dynamically enabled/disabled by trie user 

c Au toaia tic tern-ina! speed detection 

o Automatic CONNECT to a DEDICATED or PREF ERRED host system, the naie oi 
which may be stored permanently 

o Access control, Iifliitiny accessibility oi certain hosts to certain terminals 

o Function* to ci^tiibute terminal connect ioiis across hosts within VAX clusters 

SuUkCl CODE INFlKfeATIGN: 
No source code is provided 

MINIMUM HARDWARE REQUIRED i 
POSEIDON Terminal Server 

Any VAX-U/730, ¥AX-li/750, VAX-U/780 and wAX-11/782 system with a DtUNA 
Ethernet to UN I£U £ adapter. 

n u ttni" * r t ■ s n n u? a r 5 * 
m * * j 1 1 1« « L> u « i\ t/ •« .« ; ■ . 

None 

PREREQUISITE, SDFTfeftRE: 

For the POSEIDON Terminal Server: None 

v cr trie 'iA^/V^S system that is to supper t covin! ine loading: 

V £ X / V t': b V 4 • C 

DECntt-VAX V3.0 
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Per the VAX/VfS system that is to support lernsinai Server Operations: 



VAX/ VMS V4.0 
VAX-11 LAX VI. 



OPTIONAL SOETiARE 



TRAINING CREDITS! 
None 

SUPPORT category: 
DIGITAL SUPPORTED 

POSEIDON VI. is a DIGITAL supported software product 

SOFTWARE INSTALLATION; 
C L S 1 k E ir ( IhsIALLEi-/ 

PCSFTDCN VI. C is engineered to be installed by the Customer. 
ORDERING INFORMATION : 

All binary licensed software, including any subsequent updates, is fur nished 
under the licencing provisions of DIGITAL'S Standard Terms and Conditions of 
Sale, which provide in part that the software and any part thereof be used on 
only the single CPU for which it is intended/ and may be copied, in whole or 
in part (with the proper inclusion of the DIGITAL copyright notice and any 
DIGITAL propriety notices en the software) only fcr use on such CPU. 

Options with no support services are only ctf ail able after the purchase of one 
supported license. 

A single-use, license-only option is a license to copy the software previously 
obtained under license. 

The following Key (G,\,Z) represents the distribution media fcr the product and 
must be specified at the end of the order ruaber, e/g/. QExx:x-A¥ - binaries on 
RX01 Floppy Diskette. 

Q - TU5d DcCtape II Cartridge 
V = r'AOl r loppy Diskette 
Z ~ \'o hardware i) eoenc ency 



Sep Tab I n ? foe avai lab Je options 
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T AfaLE I 

+ . , . , . , ... , , -„ , _ 4 

j Jpticns | Sy Steffi | 
+ , — , . , . , — . — — «„ — . . — . — . — . — + 

i a t-r * -f ■% jf <rt /\ i 

I I ¥#kA- 11/ /OU | 

i 1 VAX-11/730 VAX-11/750 VAX-li/782 J 

+ . . . , — . , — + 

I single-use license, binaries/ j I 

I Documentation, Support Svcs | CC-xxx-AG QD-xxx-AG QE-xxx-AY J 
+ . , , , ... , — . , — . — _+ 

i Single-use i icense,no binaries i I 

j no support. Documentation j £C-xxx-DZ iC-xxx-DZ Q£-xxx-£Z j 
+ — , . , — , , , . — . + 

ADDITIONAL SERVICES; 
TiiS 
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APPEAL IX B 
PGSEIDO& ADDP£3S StkCE 

1C0040 +■ ■ — ■ — — — — 

1 Ethernet Address (ROM) I 
1C0O0O + -< — — — ♦ 

• • • 

• • • 

leeooo — ■ — ■ ■ — — — ■ ■ — ■ — ■ - — - — — + 

I initial ization j 

I Microcode (KGM) j 

I 6 & i 

182800 + ■ ■ ■ — ■ ♦ 

i Liagao*>tic Software ) 

i 10 K j 
ItfOGGG ♦ 

• • • 

• * • 

l V ^ X V T — — » — : ~ — + 

\ HI Chip I/O Page J 
10B0CG ■ — ■ ♦ 

• • • 

• * • 

luOObU + ' — -4 

j D U A R T I/C Page i 
100000 + — - — ■ + 

• • • 

• • • 

fcOdGC + ■ ■ ■ — — ■ -—4 

i ^on-volatile Memocy J 

I Parameters 0.5 K \ 

80000 ♦ - ■ ^ — -+ 

• • » 

a • • 

20000 + — ■ ■ ■ ~ -+ 

I i 

i i 

i Randois Access Memory 1 

I 9. Ah' Area J 

I (Details on Next Page) J 

I i 

j 127.5 fv i 

2UC «■ ~ * 

I Vectors .5 K | 

ij •+ ■ - 4 
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POSEIDON *£&Gfi* LAkClil 



20000 +■ ■ — — . «— — + 

i Initialization RAM 128 fa 1 

IFF 80 ——————+ 

i Cft ISH/TK At Area 3*52 t i 

lPi-OC > — ■ — — — ■ ■ — ■ — — — ♦ 

i Stack I 

i 35 So b j 

IF 000 — — — — ♦ 

i Reserved for future i 

f implementations i 

i 12.0 K | 

leooo + 

i l 

! High Pod Area for I 
i Host Data Base and i 
i Dynanic Data i 
1 34.0 K I 
13800 + ■ ■ — — + 

: i 

I LOk Pool Area tor i 
i l A I Control ziocKSs i 
I Transit Duffers I 
j 14.0 K j 
iuOCC 4.— — -. --. , . . + 

I I 
J receive Buffer Area 1 

1 20 Bu£i.eti> Q 1536 each 1 

1 i 

i 30.0 K I 
8600 + ~ ■ ' — — ■ + 

J Miscellaneous Data 1.5 K I 
8200 *~ ■ ■ 4 

I i 
I LAI Software and I 

J Pure Data Area I 

j i 

I 32.0 I j 

200 + ■ ■ < — • — ~ ■ — ■ — ■ < — ♦ 

1 (Vectors) 0.6 K ! 
+ , . 4 
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NU&-V0L AT ILL ^fc^CHV LA\OUT 



Circuit Tiiser 






i 


by te 


OOu 


Keep_Aiive Timer 






i 


by te 


001 


Server dumber 








by tes 




server Type 






£ 


by tes 


004 


Server Hame Length 






1 


byte 


006 


Server Blame 






16 


bytes 


007 


Location Length 






i 


byte 


u i7 


Location 






16 


bytes 


1 8 


Privileged Password 


Length 




i 


byte 


028 


Privileged Password 






6 


bytes 


029 


Logon Password Length 




1 


byte 


2F 


uOvjon Password 






A 
u 


bytes 


030 


Server flags 






1 


byte 


36 


Spare 






13 


bytes 


37 


Checksum 






1 


bytes 


44 


bar g war e status 






j. 


byte 


U 45 


Diagnostic Test Byte 






1 

o 


oy te 


40 


... ^ jl' <~ 
/■« » . .„ • .... , ,, 






1 


I , t t C 

byte 


"hi 
4F 


"i «- lf1:.ina I r a f i* ft* f. t ti f fc / 


1 to t i"« 1 lid 1 


1 


b-t 


by Ifei 




Terminal Parameters/ 


T e i a; i n a 1 


2 


£4 


by tes 


086 


Terminal Par ameters/ 


Terfliinal 


3 


54 


bytes 


OBC 


Terminal Parameters/ 


Terminal 


4 


54 


bytes 


0F2 


Terminal Parameters/ 


Terminal 


•*j 


54 


bytes 


128 


terminal Parameters, 


T etii na 1 


b 




b y tes 


i 5E 


Terminal Parameters/ 


Terminal 


7 


54 


bytes 


194 


I e r is i na 1 P a r em e t e r s / 


Terminal 


8 


54 


bytes 


1CA 


GRAND TOTAL 2 






512 


bytes 


200 
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AFPENEIX € 
CIRCUIT STATE TABLES 

+ — . . . — — - — , . . — . — < — — . . . — ♦ 

j HALT STATE: Event.action Mext.statef 

+ _ . , . — — - — -+ 

| - Ci rcuit. tifter.event CRASH HALT I 

j - Response. timeout. event CRASH HALT I 

j - Keep.alive.timer.event IGNORE HALT I 

j - Resen<1_limit_event CRASH HALT j 

| - St3rt_fl}essage_receiveG Send.stcp.isessa ge HALT | 

| - Stop.message.received IGNGSF H ALT I 

I - ftun_ftit!S^aye_rectived Send.stOfc_messa$e HALT i 

| - Invalid. message. received if stop.message, ignore HALT I 

| else send.st op. message HALT | 

| - 1 1 lega l.message.r eceived Send.s top. message HALT I 

i - Data__aiting CRASH HALT j 

+ ■ ■ ■ — • ■ ■ — ■ -+ 

| - Ci tca\ i t rov.r.QC? st rr t irss^ni? START j 

| - Ci rcui t.disconnec t CRASH ~ H ALT i 

+ . . , , — , , + 



+ . , , , — — . — . . , , — 

j STAKT STASE; _ vent.act icns ^ext_statej 
* — . . — . — — — - — — . — - — 1 — — ■ . — — , + 

| - Circuit.timer.event IGMGRE START 1 

j - Response.timeout.event Re.send.star t.ieessage START I 

I - Keep_alive_timer.eve.nt IGNORE START 1 

| - Kesend_ limi t_eveiit Deiete_terminai delete.circuit HALT 1 

1 - St art.message. received start.circuit RiiU i 

j - Stop.iitessaye.r eceived Delete.terminals/ delete.circuit HALT I 

I - Run.mes sage. received Delete. terminals/ delete.circuit HALT 1 

| - Invaiid.message. received Delete. terminal delete.circuit HALT I 

i — 1 Heya i_ir»essaye.r ece ived Delete. terminal s# delete.circuit HALT i 

I - Datd.yait.ing 1 GNOKE START I 
.+ . . , . , . . , + 

i - Circuit.connec t CRASIi HALT I 

I - Circuit. disconnect bend.stop.messa Qe, delete.circuit HALT I 
+ , . . — . . . . — . — — < . + 
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i 


M 


AIT STATE: 


Event.actions 




flex t_state 1 


i 


mm 


Circui t. timer. event 


None 




y i Tin 

IS AIT 


1 


1 


■mm 


Response. timeou t. event 


ft e.s en d__ run_i es sage 




Ii AIT 


1 


i 




K *- p n ^ ! i y m t \ Hi t- I \# i-* i i T 


W O IJ 6 




f *T I! 


1 


i 


- 


Resend_ limit. eve n t 


iarn_users 




WAIT 


| 


i 




Star t.nessage.r eceiv ec 


aone 




RUH 


! 


1 


mm 


Stopjnaessage. received 


Deiete.ternsinai delete. 


cricuit 


HALT 


1 


i 




Run_iRessage_received 


P r oc e ss.r un_ ses sa g e , 






1 


i 






If data_t lag.se t 




mu 


I 


I 






else 




«* AIT 


i 


i 




Inval id.inessage.r ece iveci 








i 


i 




11 1 eg a I. 01 ess age. received 


Send.stop.«essage, delete. 


.ter isinals 


s 


i 


i 






aeiete.circui t 




ti ALT 


i 


i 




D *s t <a_ in ci i tiny 


ftone 






i 


i 










!:SLT 


i 
* 


i 




Circuit.disconnect 


Send__s top__E essac^e, delete. 


.circuit 


H ALT 


! 



| Si ATE; Even t__ac t ions Mext__>tate I 





Circui t.titBer.event 


Send. run. mess age, 






1 






If data.st ill. waiting 




HUN 


1 






else • • . • 




iiAIT 


i 




Response. timeout. event 


Pe.send.run.ffiessage 




RUN 


l 




Kee^.ali ve.ti&er. event 


IGliGKE 




HUH 


l 




Resend. limit. event 


*iarn_users 




RUN 


i 




Star t_ m ess a ge__ received 


fcone 




HUN 


l 




Stop.message.c eceived 


eiete__tera? inal delete. 


circuit 


H ALT 


! 




ftun.message.receiveti 


t rocess__ruii_fliesiage 




RUH 


1 




Invalid.ff>essaye.r eceived 


iione 




RUN 


I 




1 1 1 £ cj o 1 _e esi>a g e._r ece iv e d 


S en d. s tc p_e e s sa ge , delete 


terminals, 




1 






delete.circuit 




HALT 


1 




Da ta.wa i ting 






RUM 


i 




Ci rcui t.connec t 


CRASh 




ii ALT 


1 




Circuit.disconnec t 


Send.stOfcJ.Kessaye, delete. 


.circuit 


HALT 


i 
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APPEMCIX D 
SLOT STATE TABLES 











1 


HALT STATE: 


i*vent_acticns 


Next_state I 


i 


w w * a a .* **—_»*■■ >J ** 


C r e a f e terfitinal^' sen d s 1 3 r t _«> lot 


START I 


I 


~ Star t_sio t_r eceived 


Send_stop_slot 


HALT | 


i 


- S tcp_sio t_rece ived 


None 


ALT | 


i 


- Rejec t_slo t_r eceived 


none 


HALT | 


i 


- A 1 1 en t i o n_.s io t_ r ec e i v ed 


None 


HALT f 


i 


- I nvali d_ siot_r eceived 


None 


HALT | 


i 


** Tr a nsiui t_.<b X o t_t> i oc aai»td 


Z H 1 e t tet'iU iii al 


HALT I 


1 


- Disconnect_re«_ues t 


CBAS11 


HALT J 



+ : ■ , , , ■ , + 

I START ST AT£ ; ven t_ac t ions .Next_state I 

4 , , , . , , 4. 

1 - r!onriect_reqiiCSt CRASH HALT f 

I ~ Stai t_siot_£ eceived Star t_ teittiiiai kUH 1 

1 - S tQy^sl u t__i eceiveu «one START | 

I - Re ject_slot__received Delete., terminal HALT 1 

1 - Attentici3._sj.ot_ 1 eceived ftone START J 

I - Tnvalid_slot.,r eceived None START j 

! - Transitu t_slot_processed None START I 

| - Diseonnect_request ftone HALT j 

4 . . , , , . , — , . , . . . , . 4 



i 


RUH STATE ; 


Event_ac tions 


Hext^s tate J 


I 




Connects re quest 


C R A S 1 i 


HALT I 


i 




S t a r t_s 1 1_ re c e i v e a 


None 


urn i 


i 




Stcp_siet_ received 


Delete_ter»inal 


HALT 1 


i 




Re ject_£lo t_ receive a 


ft one 


RUN j 


i 




A 1 1 e n t i on_s i 1 _ 1 e c e i v e d 


Process_atten ticn_sl ot 


mu i 


1 




In valid. slot. received 


Send_s top_slc t 


HALT I 


i 




Transaii t_siot_p£ocessed 


None 




i 




Disconnect.! ^quest 


3end_stop_slo t 


HALT j 
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APPENDIX £ 
**ESSAG£ FCP*4ATS 

There are five types of messages exchanged feetyeen server and host 
CGMFIGUitAIIQfc/ PATCH/ START/ RUN and STOP. formats are shown below: 

E.l COKF 1GUKAT2GN Message Format: 

a. *j v 
4-. ■ 4 

\ Destination J 

j Address i 

1 6 | 

4 . . . . , . 4 

1 Source I 

I Address j 

i 6 j 

4 — . , 4 

I Protocol Type 2 | 
4 — , , , . , — 4 

I i rru l 1_ t ip<p r J *r f»ss 3tje_t yp - 1 
4 . . , , - + 

1 L c_L AT_v ersion i IU_L AT_ver sion 2 
f , . * 

I Prutocoi^feCC I Pro tocoi_v ersion i 

+ — , , , 4 

i Change_tlags j Wsg_ incarnation 2 

4 , . , ., . . , 

1 fca*isiiua_datc — link_i rai»e_5iZ6 j 
+ . . . — , , 4 

I Postdating I Nufaber_oi_iiaffies I 

4 , . -4 

i I Host_nanie„ length I 
I + JZ — — — + 

mm *■> 

| acst_nafiie I 

i 1-16 i 

4.. , — — . , — . . — . ~~ — 4 

~ Last_three_l ields repeated 

M nu«iber_of_nan?es** - 1 tiiees " 
+ ■ ■ — ■ • ■ ♦ 

I I Ident.lenyth 1 
j — „ ———4 

j Identification 2 

I 1-64 I 
+ . _ — 1 

i I ^uirfcer_ci_ groups I 
I 4 . 4 

i Groii±>_codes j 
i 1-I6 i 
4-. . — , , — . 4 Con t inyed * » . « . 
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Continueu..... + — ■ ■ --■ + 

I I Humb eraser vices j 

I +— — ———————————— .— 

1 Service_ciasse$ j 

i 1-255 | 

, . — . — — — — — -4 
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E.3 STAHT Message Forwat: 

15 
+ — . . , . 4 

I Destination I 

i Address 1 

i 6 I 

4 . — . . -4 

I Source ) 

| Address I 

I 6 I 

4 . , , , , . „ —4 

I Protocol Type 2 | 
4 -- — ■+ 

1 | «stj_tyte 44/0) i 
4 . , , , , . 

I Des tinat ion_circu it_ident if ier I 

4_. . , . — -■ . . . 4 

I Source. circui t.identif xer I 
+ ... . — - — + 

1 r, c i * j * I - u u ii c r t j| ] LtcjioHCi- f* 1 
+ -. — . . — . + 

1 Ha.xiiiiuas_da ta.iink.f raice_size | 

■ — ■ • + 

f Hdroyare I 

i Ethernet 1 

i Address 6 I 

4~ , , , , , — . 4 

i Protocol^ tec I eioeo toi_v erison I 

♦ — ■ ' ' ■ 4 

I | Hax.Nusber. terns i 

4 — — — — -4 

1 Keep_aiive_tiffier J Circu it_ti»er J 

4 , . - , 4 

i Ser ver_nu»ber 2 | 
4 , — , — , . — 4 

i £»eiver_type 2 | 

4 , . ~ . -4 

j I Length_o liaise J 

| 4 ——4 

I Secver nase 1 

I ~ 0-16 1 

4 — , , , . - — 4 

1 | Loca tion_l trig th i 

£ 4 —4 

I L c c a t i o n I 

I 0-1(3 | 

4 . . 4 
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£.4 RUN HfcSEACE FORi*. AT 



15 

•4--- ' --—4 

i Destination J 

I Address j 

i 6 I 
+ - + 

i C n iif re 1 

| u u i v C j 

i Address I 

I & I 

+ -. . — . 4 

1 Protocol Type 2 I 

4. . , ■ , . , 4 

I Muii.b t-r_di_i» lu tb 1 Msg^ty^e {0/2) I 
+ . ... ... , — , . — , + 

j 0€3tii}3tion_circiiit_icentiti er j 

+ — ; , , • 4 

J Source_ci ecu it_identif ier I 
* — , , — . . — . — , , -4 

I &c k no*! ^ooetwen t $ f S*»qu<*nre U | 

+ — ■ ■ 4 



SlCI DMA 

C-1492 . 

^ — , «. , , . — * 
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tmb MESSAGE SLOT rO^MATS 



Start Slot 



7 
* ■ ■ + 

I Dest_slot_idei'it j 
4 ------ , 4 

| Source_slot_ident i 

+ ■ - * 

J P.yte_ count I 

4- -. , -.-4 

f Type 9 I Credits ! 

+ === = =:== = ===:s ===s:=: = 4 

I Servica_class 1 j 
| At tent *rs_sict_£>i ze | 

4 4 

I Data_t>_slot_size j 
+ . , 4 

| Data_a_slot_size f 



Data_a Slot 



7 C 

+ — . - 4 

1 i>est_slot_iden t 1 

4 , ... 4 

I Source_slot_ident i 

4. _, — 4 

i eyte^court | 

4-, . — . --. 4 

J Type I Credits | 

4 = - = - = = =^ = = = = = = = = = 4 

i i 

~ Siot_data 

i 0-255 i 

4------ 4 



Stop/Reject Slot 



7 

+ , , "4 

I Dest_£ict_ident I 

4 . 4 

I Source_slot_ident 1 

I fcyte_count I 

+- — — — — — — — + 

I type tt | Reason | 

4 = = = = = = = = = = = = = 



b top Slot 

i*-13 Reject Slot 



Data b slot 



7 
4. — , — — + 

i Des t_sl t.ident 1 
4 . , — -_ --4 

f Source_siot_ident i 

4— , , -4 

i Byte_count 1 
♦ — . 4 

f Type 1 i credits i 

I Control_f lai,s 1 
4-. , — — . — , — 4 

J Outi>ut_XOFF_char I 

.4 , , 4 

1 Qu tyu t_XGii_chai i 
4— — ~, — — , —4 

I Inpy t_XOFP_chai J 

4 . __ + 

I lnput_XGN_char I 

4 . , 4 



Jtention slot 



7 d 
4. , , — 4 

i Des t_slot_ident I 
4-, — . , — —4 

i Scurce_£lot_itient i 
4. — - —4 

I Byte_count ! 
4.. — , , -4 

i Ty*e 11 i i) I 

+ = = = = = = = = === = =: = = = =:= 4 

I Ccrtrci_f lacs i 
4. — --, — , 4 



Cr 6dit_«ti thdra«ai_siot 



7 
.4 , 4. 

I Dest_slot_ident i 

-4 — . — . — — . — 4, 

I Scurce_slot_ident I 
4 , — , 4. 

i Byte_count I 
4- — — ■ ■ — —4. 

I Type 15| Credits i 

+ = === = = = ====::==:= = = ==4. 
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E.6 5 TOP Hessage Format: 

15 
+ . . . , , — 4 

I Destination ) 

i Address 1 

I 6 I 

+ ■ ■ ■ ■ ■ + 

J Source I 

I Address I 

i 6 i 

— . . 4. 

I Protocol Type 2 i 

4, — , , -~ — - — .4 

i I ^sg_t.ype (d/IO) i 
+ , , — . . — . . — . — + 

I Destinat ion_circuit__identitiet I 
4 , — . . 4 

I i 
4 — -4 

I : 1 * I 

4 -_«.--- —.-——4 

i *eason_lertgth I *<€ason__c ode | 

4 . , 4 

i i 

ixeason_text 
I j 

4 4 
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APPENDIX F 
SfcG*i DISPLAY FORMATS 

^on-privileged: 

F.i SEQH CONNECTS 
Terms k_6ftILE¥ 

Host; DELPHI VAX/V*S Development System 



F.2 SHOE HOSTS 



Host Name 




Status 


I dentil 'lea t ion 




* CROUP * 




3FLFPI.., 


».**..* 


KeachaMe 


32-rit Advancec Oeve Icpsient system 


STAR...*. 


>...... 


Lnr eacnable 


VAX/VMS Development 


lii t\i..i i • « l 


»•*•••• 






AL1FN.... 


»•••••• 


Cver due 


RSX-11M Development System 


EL&GMD. .... 


>...... 


Lnr eacftajjifc 


kSX-IIn-^LLS y evelopffien t System 


•J M A U b • . • . • « 


• ••••»• 


H e c?£fi fit- Ifc 


Districted System Software Development 






Reachable 


Distributed Systems Pngmeeriny 






he act) able 





F.3 SHOW HOST ELKOND 



ELhQND. • • » . • 
RSX-llfc-PLUS 



... he ach able 

Development System - 



ratings 25 Connected Terminals: 2 

- Distributed Systems Software Engineering 



Seconds since zeroed: 277182 
Messages Transmitted? 167902827 
messages «e- transmitted? 2891 



Messages Received? 
Duplicates Received? 
Illegal Messages Rev 
Illegal Slots Pcv'd 



17872872 
1127 
1 



F. 4 SHOW Iz. i lu Al 



Terra: :<_ f ^lL!-V 
iccess: */ C- / • ) 

Type: an', i {hh L) 

Autoconnec 1: 1 : a ( a) 
fcude CI. ar : i - ( r * r. } 
Loss I o fit : 1, 4 



( H_B AiLEX ) 

17 P Speed: 960C (96C0) 

fj/t Speed: 9600 (96C0) 

Char Size: C^) 

Polity? UUll (NC1»£) 

stor Pita: * (2) 



1/P Flo* Ctl? Ek A (EM A ) 

O/P Flo* Ctl? EkA ( EM A) 

Framing Errors? 

Parity Errors: C 

Over run Errors: 



C ur r e n t h o s t ? .« • ? 5. 

preferred Host: Lfri'JG (SMUC-Cedicated) 
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Privileged : 



F.5 SHOl ALL CO«feECTS 



Term: 
Host : 



DELPHI 



VAX/V^S Development System 



Term: I 
Hos t : 



D_G AT TON 
* LOCAL * 



Term: 2 
Host: 



K_ G F U D A 

ORG 



Distributed Systeas Engineer ing 



Term: 3 
hos t : 



B_KELL¥ 
* LOCAL * 



etc etc 



F.b SHOW COUNTERS 



£TiiE«*ET CLUSTERS * 



Seconds since zerocc: 122 < 

Byte:, f ac^ived: 172Pt>ei 

Bytes Sent: 789763 

Frames Received: 12691 

frames Sent: 11627 

multicast Bytes kcv'ci: 17 61 

Multicast faytes Sent: 

Multicast frames Pcv'i: 118 

multicast Frames Sent: 

Frames sent, deferrec: 12 

Frames sent, 1 collision: 1 

Frames sent, 2-*- collisions: 



txceiiiive collisions: 
Carrier Check taiiure: 
Prase too long: 
Heartbeat absent: 
Late collision: 
Data uncerrun: 
Block creek error: 
framing error: 
Data overrun: 

System buffer unavailable: 
User buffer unavailable: 



* SERVtF? COUNTERS * 



Mess ages 
messages 
messages 



Received: 
Transmitted : 

be- tiansmi t ted 



17872^72 Duplicates Received: 

187902827 Illegal messages Rcv'd: 

2091 Illegal Slots Rcv'd 



F.7 ShOfc ALL HOSTS 



bame as SHCfc HOSTS, except that All hosts in 
the data base are shown (not just authorized 

iiOStS) 



POSEIDON 
APPENDIX 
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i.t SI! 



POSEIDON Sottyare VCl-001 



Microcode V01-001 



Diagnostics V01-001 



Address : 
kame t 
Location 
i'4 ufitu fcr : 



AA-9fc-OC-49-*l-0C 

Marketing Pod 

BLDNG 4, StCT 

1 it 



Circuit Timer : 060 (080) 
Keepalive Tiaer : 030 (030) 



Server Status: 
lerisinai Status; 
Hardware status: 
U P t i si e (seconds) 
Softyare Status: 
lump Host; 



000 000 000 000 000 000 



0000 

000 000 
F0 

1 c ') Ann 
x j <t v v 

1FC2-2700-1FD6C 
AO-12-G0-1A-25-O1 



F . i 



Tc.t<fc ii*AL ii 



aaie as StiGk i'En^ifc except that terminal n*s 
parameters are displayed 
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APPENDIX G 
HELP DISPLAY fCkk ATS 

G.l Non-pt ivileyed HELP Display 

LGC AL> MLP 

The following commands are available: 

CONNECT LOGOFF SHQ$ 

DEFINE *ESOK£ TEST 

y TSCONN FCT SFT 

For Eore in I cruiaticn on a yiven c ob it, and / type HELP c outsail d« 

Gm'z Priviieyec EELE Display 
?FIY_LCCAL> EFLP 



For sore information on a yiven cosnand* type HELP conaand. 

G.3 Cosimand HELP Displays 

- To De provided/ toileting initial documentation release. 





Sou y 

SiL r 
TEST 
ZEHO 
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APPENDIX G - HELP DISPLAYS 

APPENDIX h 

o Fatal Hardware Error — Alert users, crash system, invoke self-test 
o Fatal Software Error — Alert users, crash system, invoke self-test 

o Ethernet Transmit Error (. k l K tf) — Court error, retry 10 times, then 

alert users 

o htnernet &eceive Error (CkC) — Count error, and ignore message 

o Ethernet Hear to eat Error — It diagnosed at self-test, ignore 
else count error and atteapt to continue (higher level protocol 
will alert users etc) 

o Utiier Ethernet errors — Define into classes; 

- Fatal tiatdware Error - Alert lasers, crash system, invoke test 

- Network Error on Transmit - Count error, retry up to 10 
tines, then alert users 

- Network Error on Receive - Count error, ignore message ana 
continue 

- Miscellaneous non-fatal error - Count error and continue 

o U AfcT parity/ overrun/ framing error - Count error, ignore character 
ana continue. Error is not reported tc host: 

o Human user snould re-type character 

o fccr-huiaari input aiust have higher-level protocol with 
data verification, and retry operation upon error 



o HAN checksum error - 



- Alert users, use system default parameters* 
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o Host siessa^e timeout *etrarsmi t last message 10 times, then 
alert users. It autoeonnect enabled, attempt reconnection to host 



o Illegal host message — fake dcwr virtual circuit, and alert users 

If 3us toconiiec t enabled, attempt reconnection to host 



o user input eircr in Local aiode — Igncre input and issue error 

message 



c 10-second katchclog titter expires (hardware) — Simulate power-fail 
and invoke sell-test 
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APPENDIX 1 
DOWNLINE LOAD PROCESSING 



POSEIDON bottyate is downline loaded into the Terminal Server hardware 
utilizing the standard Maintenance Operations protocol (MOP). The POSEIDON 
Downline load procedure incorporates a JRGIHbased TERTIARY LOADER, which 
requests the POSEIDON software image via the SGFTteAR£_ID field in a REQUEST 
PROGRAM message. 

The loaa process contains the following steps: 

o Upcn successful self-test/ a REQUEST PROGRAM message, specifying file 
rSueOlEN'G.SYS as the SUFT*ARE_1D/ is sent to tne LOAD ASSISTANCE 
volunteer aulticast address. 

o Hosts systems that support this mess age will read the SOFTWARE_ID 
field, and « ITliGDT ACCtSSIIiG A BECnet DAT AEA5E# will attempt to locate 
the file under the system load default directory. For VAX/ VMS, this 

CV.:cynTrr: ;?C SYC. It tre hcst finds the file, an* wishes to 

volunteer load assistance/ it sends an ASSISTANCE VOLUNTEER message to 
the requesting POSEIDON. Many load nests may volunteer. 

o The PGSEIDCB y 1 1 1 then receive one or pore ASSISTANCE VOLUNTEER 
messages. It selects the FIRST message, then sends a REQUEST PROGRAM 
message aycin, addressed to the selected load volunteer. 

o The load host then receives a REQUEST PROGRAM addressed specifically 
to it# and initiates loading. It sends a MEMORY LOAD message 
(containing the first record of the PCSEIDCN scftyare image) to the 

POSEIDON. 

o Upon each receipt of an in-sequence memory load record, POSEIDON loads 
memory then issues a REQUEST KE^CRV LOAD message. 

o Khen the host receives a REQUEST ^EMQRM LOAD message, it sends the 
next record of the POSEIDON software in a ^EHORY LOAD message, and so 
on until all records have ceen sent. At this pointy the host sends a 
dummy PARAMETER LOAD VilTH TRANSFER ADDRESS record to the POSEIDON. 

o Upon receipt of a PARAMETER LOAD iUTH TRANSFER ADDRESS, POSEIDON 
acknowledges with a final REQUEST MEMORV. LOAD, then starts the 
so f tware. 

o in en the host receives the final REQUEST MEMORY LOAD message, it 
terminates tne load operation. 
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APPENDIX J 
UPLINE DUMP PROCESSING 



Upon ay stum crash, the POSEIDON aieasory iaage may De upline dumped to a host 
processor. Th is process utilizies the standard Maintenance Operations 
protocol (yGP). 

The dump process contains the following steps! 

o Upon crash, a REQUEST DUMP SSRVICE message, specifying file 
PS0801ENG.IMG as the SGirTiiARE_ID, is sent the host system that 
downline loaded the software into the POSEIDON. It this host chooses 

to service the duap request, it issues a REwUEST MEMORY DUMP message 
to the POSfclLGft, and the next three steps are eliminated. 

o If the load host does not respond tc the dujap request within 10 
seconds, POSEIDON will issue a REQUEST DUMP SERVICE message to the 
LOAD ASSISTANCE volunteer multicast acdress. 

o Hosts sy stents that support this aiesscye will read the SOFTWARE.. ID 
lie id, ana % IThOUT ACCESSING A OECnet DATABASE, will attempt to verily 
whether they support dump service. 1 1 the host wishes to volunteer 
duftp assistance, it sends an ASSISTANCE yULUNTEEk message to the 
requesting POSEIDON. Many du»p hosts a ay volunteer. 

o The POSEIDON will then receive one or more ASSISTANCE VOLUNTEER 
Messages* it selects the F lis ST message, then sends a REQUEST DUMP 
SERVICE ffiessage again, addressed to the selected load volunteer. 

o The diiap nost then receives a REQUEST DUMP SERVICE addressed 
specifically to it, and initiates duaping. It sends a REQUEST MEMORY 
DUMP message to the POSEIDON. 

o Upon each receipt ol an in-seguence REQUEST MEMORY. DUMP, POSEIDON 
issues a MEMORY DUMP message, containing image data for the next 
section of seiBory to be du&ped. All of PGSfclDON sesory, including 
code, is d tfflped • 

o ^hen the host receives a MEMORY DUMP ire ss age, it stores the inage in 
the next tecord of tfce POSEIDON duasp tile, then sends another REQUEST 
MEMORY DUMP record to the POSEIDON. 

o This contir.iues until the POSEIDON rurs out of memory to dump, at 
which time it sencs a DUMP COMPLETE lessage to the host. At this 
point, tne p l & * ! t u & will eitner breaK-mto uOT tor post-ounp analysis 
(it enabled), or start the diagnostic sel f-test. 
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/tpPtM/IX K 



HARDWARE REQUIREMENTS 



Q 



68000 microprocessor (10 MHz) / yhich effectively runs 
at 7*35 «Bz. Clock period is thus 136 nanoseconds* 



o \nait states are imp lea en ted tor accesses to ROM and litf—RAM only. 
HhM, UAHTS and l*jNC£ accesses involve no wait states. 

o Ethernet EM transfer rate is one yore per 1-6 Microseconds 



a «orst-case LANCc. ase&ory cycle tiae is tOO ns per words with 680 ns 
ht»*-' » r 1 1 f ■ 3» 1 1 ^ n r«t ^ wor^s in *h i- r *? t if o ~i e • ** o r the 1 272 n s 1 
the bus arbitration., the CPU way not access the bus. Therefore 
vluriny DMA/ software effectively &ay utilize only 47. 8fi% of the CPU. 



it is assuiec that tne UAkTS handle iSiOu full duplex 1/0/ and tnat 
the LANCE handles 1€ Vhz Ethernet traffic without overruns. 



o It is assumed that an interrupt occurs for each input and output 
characters and on errcr and break conditions. These interrupts occur 
only anen the AN T is ready/ and at tfce designated vector and 
priority level. 



It is sssmed tnat an interrupt occurs lor every packet received from 
the Ethernet (addressee to the station or designated multicast 

addresses ) * 



(1 A J - 5-, » 
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APPENDIX 2 
OUTSTANDING ISSUES 

The following issues remain outstanding kith this release cf the Specif ication. 

3.1*3.99.1 extent of Autobaua Functionality to De defined after 
laipieiii entation 

3.3.3.9S.1 Define Test Options icr Initialize command. 

3.3.4.99.1 Status Message Codes to be defined. 

11.0.99.1 Maintenances Final strategy to be defined following Phase 1. 
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